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(https://docs.spring.io/spring/docs/4.3.13.RELEASE/spring-framework-reference/html/). The 
current version of Spring Framework 4.x is 4.3.9.RELEASE. There is also a GitBook version 
of the book: http://waylau.gitbooks.io/spring-framework-4-reference. Let's READ! 

«Spring Framework 4.x 参 考 文档 》 中 文 翻译 (包含 了 官方 文档 以 及 其 他 文章 ) 。 至 今 为 止 ， 
Spring Framework 的 最 新 版 本 为 4.3.13.RELEASE ° 
利用 业余 时 间 对 此 进行 翻译 ， 并 在 原文 的 基础 上 ， 插 入 配 图 ， 图 文 并 茂 方便 用 户 理解 。 如 有 
勘误 欢迎 指正 ， 点 此 提问 。 如 有 兴趣 ， 也 可 以 参与 到 本 翻译 工作 中 来 :) 


Get start 如 何 开 始 阅 读 
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e https://github.com/waylau/spring-framework-4-reference 的 SUMMARY.md (源码 ) 
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Github : waylau 


Part I. Overview of Spring Framework Š% 


Spring Framework 是 一 个 轻 量 级 的 解决 方案 ， 可 以 一 站 式 构建 企业 级 应 用 。 然 而 ，Spring 是 
模块 化 的 ， 允 许 你 使 用 的 你 需要 的 部 分 ， 而 不 必 把 其 余 带 进来 。 你 可 以 在 任何 框架 之 上 去 使 
用 IOC 容 器 ， 但 你 也 可 以 只 使 用 Hibernate 集成 代码 或 JDBC 44 RE ° Spring Framework 支 
持 声明 式 事务 管理 ， 通 过 RMI A Web 服务 远程 访问 你 的 逻辑 ， 并 支持 多 种 选择 持久 化 你 的 
数据 。 它 提供 了 一 个 全 功能 的 MVC 框架 ， 使 您 能 够 将 AOP 透明 地 集成 到 您 的 软件 。 


Spring 的 设计 是 非 侵入 性 的 ， 也 就 是 说 你 的 领域 逻辑 代码 一 般 对 框架 本 身 无 依赖 性 。 在 你 的 
ERE (如 数据 访问 层 ) > — 问 技术 和 Spring 的 库 一 些 依赖 将 存在 。 然 而 ， 它 应 该 很 
容易 从 你 的 剩余 代码 中 分 离 这 些 依赖 。 


本 文档 是 Spring Framework 功能 的 参考 指南 。 如 果 你 有 关于 这 个 文档 的 任何 要 求 ， 意 见 或 问 
题 ， 请 发 送 到 用 户 邮 件 列表 。 对 Framework 本 身 的 问题 应 该 到 StackOverflow 请 问 ( 


https://spring.io/questions ) 


见 
见 


译 者 注 : 对 本 文档 的 翻译 有 任何 问题 ， 请 在 https://github.com/waylau/spring-framework-4- 
reference/issues 上 面 提问 


开始 


本 参考 指南 提供 了 关于 Spring Framework 的 详细 信息 。 提 供 它 的 所 有 功能 全 面 的 文档 ， 以 及 
Spring 所 涵盖 的 一 些 关于 底层 方面 的 背景 资料 (如 “Dependency Injection (依赖 注入 ) ”) 。 


如 果 你 是 刚刚 开始 接触 Spring， 你 可 能 要 开始 使 用 Spring Framework 创建 一 个 基于 Spring 
Boot 的 应 用 。Spring Boot 提供 了 一 种 快速 、 自 动 配置 Spring 各 种 组 件 的 方法 来 创建 一 个 用 
于 生产 环境 的 Spring 的 应 用 程序 。 它 是 基于 Spring Framework， 约 定 大 于 配置 ， 目 的 是 快速 
搭建 一 个 可 以 运行 的 应 用 。 

您 可 以 使 用 start.spring.io 创建 一 个 基本 项 目 或 遵循 一 个 类 似 于 Getting Started Building a 
RESTful Web Service 的 “入 门 "指南 。 这 些 指南 都 非常 专注 于 具体 的 任务 ， 其 中 大 部 分 是 基于 
Spring Boot， 非 常 容易 理解 。 这 些 还 涵盖 了 你 可 能 想 解 决 一 个 特定 问题 时 要 考虑 到 的 其 他 
Spring 项 目 。 


介绍 Spring Framework 


Spring Framework 是 一 个 提供 完善 的 基础 设施 用 来 支持 来 开发 Java 应 用 程序 的 Java 平台 。 
Spring 负责 基础 设施 功能 ， 而 您 可 以 专注 于 您 的 应 用 。 


Spring 可 以 使 你 从 “简单 的 Java 对 象 ”(POJO) 构建 应 用 程序 ， 并 且 将 企业 服务 非 侵 入 性 的 应 
用 到 POJO。 此 功能 适用 于 Java SE 编程 模型 和 完全 或 者 部 分 的 Java EE 。 


举例 ， 作 为 一 个 应 用 程序 的 开发 者 ， 你 可 以 从 Spring 平台 获得 以 下 好 处 : 


e 使 Java 方法 可 以 执行 数据 库 事务 而 不 用 去 处 理事 务 APl。 

。 使 本 地 Java 方法 可 以 执行 远程 过 程 而 不 用 去 处 理 远程 APl。 
。 使 本 地 Java 方法 可 以 拥有 管理 操作 而 不 用 去 处 理 JMX API ° 
o 使 本 地 Java 方法 可 以 执行 消息 处 理 而 不 用 去 处 理 JMS API ° 


依赖 注入 和 控制 反 转 


Java 应 用 程序 -- 运 行 在 各 个 松散 的 领域 ,从 受 限 的 瞪 入 式 应 用 程序 ,到 mn 层 架 构 的 服务 端 企业 级 
应 用 程序 -- 通 常 由 来 自 应 用 适当 的 对 象 进行 组 合 合作 。 因 此 ,对 象 在 应 用 程序 中 是 彼此 依赖 。 


尽管 Java 平台 提供 了 丰富 的 应 用 程序 开发 功能 ,但 它 缺 乏 来 组 织 基本 构建 块 成 为 一 个 完整 的 

方法 。 这 个 任务 留 给 了 架构 师 和 开发 人 员 。 虽 然 您 可 以 使 用 设计 模式 ,例如 Factory, Abstract 
Factory, Builder, Decorator, 和 Service Locator 来 组 合 各 种 类 和 对 象 实例 构成 应 用 程序 ,这 些 
模式 是 :给 出 一 个 最 佳 实践 的 名 字 , 描 述 什 么 模式 ,哪里 需要 应 用 它 , 它 要 解决 什么 问题 ,等 等 。 模 
式 是 形式 化 的 最 佳 实践 ,但 你 必须 在 应 用 程序 中 自己 来 实现 。 


Spring Framework 的 Inversion of Control (loC) 组 件 旨 在 通过 提供 正规 化 的 方法 来 组 合 不 同 
的 组 件 成 为 一 个 完整 的 可 用 的 应 用 。 Spring Framework 将 规范 化 的 设计 模式 作为 一 等 的 对 
象 ,您 可 以 集成 到 自己 的 应 用 程序 。 许 多 组 织 和 机 构 使 用 Spring Framework 以 这 种 方式 来 开 
发 健壮 的 、 可 维护 的 应 用 程序 。 


控制 反 转 和 依赖 注入 的 背景 


“ 同 题 是 ，[ 他 们 ] 哪 些 方面 的 控制 被 反 转 ? "这 个 问题 由 Martin Fowler 在 他 的 Inversion of 
Control (loC) 网 站 在 2004 年 提出 。Fowler 建议 重新 命名 这 个 说 法 ,使 得 他 更 加 好 理解 ,并 且 提 
出 了 Dependency Injection (依赖 注入 ) 这 个 新 的 说 法 。 


译 者 注 : Dependency Injection 和 Inversion of Control 其 实 就 是 一 个 东西 的 两 种 不 同 的 说 法 
而 已 。 本 质 上 是 一 回 事 。Dependency Injection 是 一 个 程序 设计 模式 和 架构 模型 ， 一 些 时 候 
也 称 作 Inversion of Control， 尽 管 在 技术 上 来 讲 ，Dependency Injection 是 一 个 Inversion of 
Control 的 特殊 实现 ，Dependency Injection 是 指 一 个 对 象 应 用 另外 一 个 对 象 来 提供 一 个 特殊 
的 能 力 ， 例 如 : 把 一 个 数据 库 连 接 以 参数 的 形式 传 到 一 个 对 象 的 结构 方法 里 面 而 不 是 在 那个 

对 象 内 部 自行 创建 一 个 连接 。lnversion of Control 和 Dependency Injection 的 基本 思想 就 是 
把 类 的 依赖 从 类 内 部 转化 到 外 部 以 减少 依赖 。 应 用 Inversion of Control， 对 象 在 被 创建 的 时 

候 ， 由 一 个 调控 系统 内 所 有 对 象 的 外 界 实体 ， 将 其 所 依赖 的 对 象 的 引用 ， 传 递 给 它 。 也 可 以 

说 ， 依 赖 被 注入 到 对 象 中 。 所 以 ，Inversion of Control 是 ， 关 于 一 个 对 象 如 何 获取 他 所 依赖 

的 对 象 的 引用 ， 这 个 责任 的 反 转 。 


模块 


Spring Framework 的 功能 被 组 织 成 了 20 来 个 模块 。 这 些 模 块 分 成 Core Container, Data 
Access/Integration, Web, AOP (Aspect Oriented Programming), Instrumentation, 
Messaging, 和 Test， 如 下 图 : 


Figure 2.1. Overview of the Spring Framework 


下 面 章 节 会 列 出 可 用 的 模块 ， 名 称 与 功能 及 他 们 的 主题 相关 。 组 件 名 称 与 组 件 的 ID 相关 ， 用 
于 2.3.1 节 中 的 依赖 管理 工具 。 

核心 容器 

Core Container 由 spring-core, spring-beans, spring-context, spring-context-support, 和 
spring-expression (Spring Expression Language) 模块 组 成 。 


spring-core 和 spring-beans 提供 框架 的 基础 部 分 ， 包 括 loC 和 Dependency Injection 功能 。 
BeanFactory 是 一 个 复杂 的 工厂 模式 的 实现 。 不 需要 可 以 编程 的 单 例 ， 并 允许 您 将 配置 和 特 
定 的 依赖 从 你 的 实际 程序 逻辑 中 解 耦 。 


Context (spring-context) 模块 建立 且 提 供 于 在 Core 和 Beans 模块 的 基础 上 ， 它 是 一 种 在 框架 
类 型 下 实现 对 象 存 储 操作 的 手段 ， 有 一 点 像 JNDI 注册 。Context 继承 了 Beans 模块 的 特性 ， 
并 且 增 加 了 对 国际 化 的 支持 (例如 用 在 资源 包 中 ) 、 事 件 广播 、 资 源 加 载 和 创建 上 下 文 (HI 
如 一 个 Servlet 容器 ) ° Context 模块 也 支持 例如 EJB > JMX 和 基础 远程 这 样 的 JavaEE 特 
性 。ApplicationContext 是 Context 模块 的 焦点 。spring-context-support 提供 对 常见 第 三 方 库 
的 支持 集成 进 Spring 应 用 上 下 文 ， 如 缓存 (EhCache, Guava, JCache), 通信 (JavaMail), 调度 
(CommonJ, Quartz) 和 模板 引擎 (FreeMarker, JasperReports, Velocity) ° 


spring-expression 模块 提供 了 一 个 强大 的 Expression Language (表达 式 语言 ) 用 来 在 运行 时 
查询 和 操作 对 象 图 。 这 是 作为 JSP2.1 规范 所 指定 的 统一 表达 式 语言 (unified EL) 的 一 种 延 
续 。 这 种 语言 支持 对 属性 值 、 属 性 参数 、 方 法 调用 、 数 组 内 容 存储 、 收 集 器 和 索引 、 逮 辑 和 
算数 操作 及 命名 变量 ， 并 且 通 过 名 称 从 Spring 的 控制 反 转 容器 中 取 回 对 象 。 表 达 式 语言 模块 
也 支持 List 的 映射 和 选择 ， 正 如 像 常 见 的 列表 汇总 一 样 。 


AOP 及 Instrumentation 


spring-aop 模块 提供 AOP Alliance-compliant (联盟 兼容 ) 的 面向 切面 编程 实现 ， 允 许 你 自 定 
义 ， 比 如 ， 方 法 拦截 器 和 切入 点 完全 分 离 代码 。 使 用 源码 级 别 元 数据 的 功能 ， 你 也 可 以 在 你 
的 代码 中 加 入 behavioral information (行为 信息 )， 在 某 种 程度 上 类 似 于 .NET 属性 。 


单独 的 spring-aspects 模块 提供 了 集成 使 用 AspectJ。 


spring-instrument 模块 提供 了 类 instrumentation 的 支持 和 在 某 些 应 用 程序 服务 器 使 用 类 加 载 
器 实现 。spring-instrument-tomcat 用 于 Tomcat Instrumentation 代理 。 


消息 


Spring Framework 4 包含 了 spring-messaging 模块 ， 从 Spring 集成 项 目 中 抽象 出 来 ， 比 如 
Message, MessageChannel, MessageHandler 及 其 他 用 来 提供 基于 消息 的 基础 服务 。 该 模块 
还 包括 一 组 消息 映射 方法 的 注解 ， 类 似 于 基于 编程 模型 Spring MVC 的 注解 。 


数据 访问 /集成 
Data Access/Integration 层 由 JDBC, ORM, OXM, JMS, 和 Transaction 模块 组 成 。 


spring-jdbc 模块 提供 了 不 需要 编写 宛 长 的 JDBC 代 码 和 解析 数据 库 厂 商 特有 的 错误 代码 的 
JDBC- 抽 象 层 。 


spring-tx 模块 的 支持 可 编程 和 声明 式 事务 管 理 ， 用 于 实现 了 特殊 的 接口 的 和 你 所 有 的 POJO 类 
(Plain Old Java Objects) 。 


spring-orm 模块 提供 了 流行 的 object-relational mapping (+ R-KARA) API 集 成 层 ， 其 包 
含 JPA，JDO，Hibernate。 使 用 ORM 包 ， 你 可 以 使 用 所 有 的 OR 映射 框架 结合 所 有 Spring 
提供 的 特性 ， 上 比如 前 面 提 到 的 简单 声明 式 事务 管理 功能 。 


spring-oxm 模块 提供 抽象 层 用 于 支持 Object/XML mapping 《对象 /XML 映射) 的 实现 ,如 
JAXB ` Castor ` XMLBeans ` JiBX 和 XStream 等 。 


spring-jms 模块 (Java Messaging Service) 包含 生产 和 消费 信息 的 功能 。 从 Spring 
Framework 4.1 开始 提供 集成 spring-messaging 模块 。 


2.2.5 Web 
Web 层 由 spring-web, spring-webmvc, spring-websocket, 和 spring-webmvc-portlet 组 成 ° 


spring-web 模块 提供 了 基本 的 面向 Web 开发 的 集成 功能 ， 例 如 多 方 文件 上 传 、 使 用 Servlet 
listeners 和 Web 开发 应 用 程序 上 下 文 初始 化 loC 容器 。 它 也 包含 HTTP 客户 端 以 及 Spring 
远程 访问 的 支持 的 Web 相关 的 部 分 。 


spring-webmvc 模块 (也 被 称 为 Web Servlet 模块 ) 包含 Spring 的 model-view-controller 

(模型 -视图 -控制 器 (MVC) 和 REST Web Services 实现 的 Web 应 用 程序 。Spring 的 MVC 
框架 提供 了 domain model (领域 模型 ) 代码 和 web form (网 页 ) 之 间 的 完全 分 离 ， 并 且 集 成 了 
Spring Framework 所 有 的 其 他 功能 。 


spring-webmvc-portlet 模块 (也 被 称 为 Web-Portlet 模块 ) 提供 了 MVC 模式 的 实现 是 用 一 个 
Portlet 的 环境 和 spring-webmvc 模块 功能 的 镜像 。 


2.2.6 Test 


spring-test 模块 支持 通过 组 合 JUnit 或 TestNG 来 进行 单元 测试 和 集成 测试 。 它 提供 了 连续 的 
加 载 ApplicationContext 并 且 缓 存 这 些 上 下 文 。 它 还 提供 了 mock object (模仿 对 象 ) ， 您 可 
以 使 用 隔离 测试 你 的 代码 。 


使 用 场景 


前 面 的 构建 模块 描述 在 很 多 的 情况 下 使 Spring 是 一 个 合理 的 选择 ， 从 资源 受 限 的 说 入 式 程序 
到 成 熟 的 企业 应 用 程序 都 可 以 使 用 Spring 事务 管理 功能 和 web 框架 集成 。 


Figure 2.2. Typical full-fledged Spring web application 


Spring 声明 式 事务 管理 特性 使 Web 应 用 程序 拥有 完全 的 事务 ， 就 像 你 使 用 EJB 容器 管理 的 
事务 。 所 有 的 自 定义 业务 逻辑 可 以 用 简单 的 POJO 实现 ， 用 Spring 的 loC 容器 进行 管理 。 额 
外 的 服务 包括 发 送 电 子 邮 件 和 验证 ， 是 独立 的 网 络 层 的 支持 ， 它 可 以 让 你 选择 在 何 处 执行 验 
证 规则 。Spring 的 ORM 支持 集成 JPA，Hibernate，JDO ; 例如 ， 当 使 用 Hibernate， 您 可 
以 继续 使 用 现 有 的 映射 文件 和 标准 的 Hibernate 的 SessionFactory 配置 。 表 单 控制 器 将 Web 
层 和 领域 模型 无 颖 集成， 消除 ActionForms 或 其 他 类 用 于 变换 HTTP 参数 成 为 您 的 域 模型 值 
的 需要 。 


Figure 2.3. Spring middle-tier using a third-party web framework 


有 时 ， 不 允许 你 完全 切换 到 一 个 不 同 的 框架 。Spring Framework 不 强制 使 用 它 , 它 不 是 一 个 全 
有 或 全 无 的 解决 方案 。 现 有 的 前 端 Struts, Tapestry, JSF 或 其 他 UI 框架 ， 可 以 集成 一 个 基于 
Spring 中 间 件 ， 它 允许 你 使 用 Spring 事务 的 功能 。 你 只 需要 将 业务 逻辑 连接 使 用 
ApplicationContext 和 使 用 WebApplicationContext 集成 到 你 的 web 层 。 


Figure 2.4. Remoting usage scenario 


当 你 需要 通过 web 服务 访问 现 有 代码 时 ， 可 以 使 用 Spring 的 Hessian-, Burlap-, Rmi- 或 
JaxRpcProxyFactory 类 。 启 用 远程 访问 现 有 的 应 用 程序 并 不 难 。 


Figure 2.5. EJBs - Wrapping existing POJOs 


Spring Framework 也 提供 了 Enterprise JavaBeans 访问 和 抽象 层 使 你 能 重用 现 有 的 POJOs, 
并 且 在 需要 声明 安全 的 时 候 打 包 他 们 成 为 无 状态 的 bean 用 于 可 伸缩 ， 安 全 的 web 应 用 里 。 


依赖 关系 管理 和 命名 约定 


依赖 管理 和 依赖 注入 是 不 同 的 概念 。 为 了 让 Spring 的 这 些 不 错 的 功能 运用 到 运用 程序 中 ( 比 
如 依赖 注入 ) ， 你 需要 收集 所 有 的 需要 的 库 (JAR 文 件 ) ， 并 且 在 编译 、 运 行 的 时 候 将 它们 放 
到 你 的 类 路 径 中 。 这 些 依 赖 不 是 虚拟 组 件 的 注入 ， 而 是 物理 的 资源 在 文件 系统 中 (通常 ) 。 


依赖 管理 过 程 包括 定位 这 些 资源 ， 存 储 它 们 并 添加 它们 到 类 路 径 。 依 赖 可 以 是 直接 (如 我 的 
应 用 程序 运行 时 依赖 于 Spring ) ， 或 者 是 间接 (如 我 的 应 用 程序 依赖 commons-dbcp ， 而 
commons-dbcp 又 依赖 于 commons-pool) 。 间 接 的 依赖 也 被 称 为 “transitive (传递 ) "， 它 
是 最 难 识 别 和 管理 的 依赖 。 


如 果 你 将 使 用 Spring， 你 需要 复制 哪些 包含 你 需要 的 Spring 功能 的 jar 包 。 为 了 使 这 个 过 程 
更 加 简单 ，Spring 被 打包 为 一 组 模块 ， 这 些 模 块 尽 可 能 多 的 分 开 依赖 关系 。 例 如 ， 如 果 不 想 
写 一 个 web 应 用 程序 ， 你 就 不 需要 引入 Spring-web 模块 。 为 了 在 本 指南 中 标记 Spring 库 模 
块 我 们 使 用 了 速记 命名 约定 spring- 或 者 spring-jar ， 其 中 * 代 表 模 块 的 短 名 (比如 spring- 
core,spring-webmvc, spring-jms 等 ) 。 实 际 的 jar 文件 的 名 字 ， 通 常 是 用 模块 名 字 和 版 本 号 级 
联 (如 spring-core-4.3.0.RELEASE .jar) 


每 个 Spring Framework 发 行 版 本 将 会 放 到 下 面 的 位 置 : 


e Maven Central (Maven 中 央 库 ) ， 这 是 Maven 查询 的 默认 库 ， 而 不 需要 任何 特殊 的 配 
置 就 能 使 用 。 许 多 常用 的 Spring 的 依赖 库 也 存在 与 Maven Central ， 并 且 Spring 社区 的 
很 大 一 部 分 都 使 用 Maven 进行 依赖 管理 ， 所 以 这 是 最 方便 他 们 的 。jar 命名 格式 是 

spring-*-<version>.jar ，Maven groupld 是 org.springframework 

。 公共 Maven 仓库 还 拥有 Spring +A WH ° RT RAN GA 版 本 ， 这 个 库 还 保存 开发 的 
快照 和 里 程 碑 。JAR 文件 的 名 字 是 和 Maven Central 相同 的 形式 ， 所 以 这 是 让 Spring 的 
开发 版 本 使 用 其 它 部 署 在 Maven Central 库 的 一 个 有 用 的 地 方 。 该 库 还 包含 一 个 用 于 发 
布 的 zip 文件 包含 所 有 Spring jar > JFR ° 


所 以 首先 ， 你 要 决定 用 什么 方式 管理 你 的 依赖 ， 通 常 建议 你 使 用 自动 系统 像 Maven, Gradle 
或 Ivy, 当然 你 也 可 以 下 载 jar 


下 面 是 Spring 中 的 组 件 列表 。 更 多 描述 ， 详 见 2.2. Modules (模块 ) 
Table 2.1. Spring Framework Artifacts 


Groupld Artifactld Description 
org.springframework © spring-aop Proxy-based AOP support 


spring- 
org.springframework aspects AspectJ based aspects 
spring- l ; 
org.springframework beane Beans support, including Groovy 
, spring- Application context runtime, including 
OPENA TA TSS context scheduling and remoting abstractions 
mal Support classes for integrating common third- 


org.springframework context- 


support party libraries into a Spring application context 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


org.springframework 


spring-core 


spring- 
expression 


spring- 
instrument 


spring- 
instrument- 
tomcat 


spring-jdbc 


spring-jms 


spring- 
messaging 


spring-orm 


spring-oxm 


spring-test 


spring-tx 


spring-web 


spring- 
webmvc 


spring- 
webmvc- 
portlet 


spring- 
websocket 


Core utilities, used by many other Spring 
modules 


Spring Expression Language (SpEL) 


Instrumentation agent for JVM bootstrapping 


Instrumentation agent for Tomcat 


JDBC support package, including DataSource 
setup and JDBC access support 


JMS support package, including helper classes 
to send and receive JMS messages 


Support for messaging architectures and 
protocols 


Object/Relational Mapping, including JPA and 
Hibernate support 


Object/XML Mapping 


Support for unit testing and integration testing 
Spring components 


Transaction infrastructure, including DAO 
support and JCA integration 


Web support packages, including client and web 
remoting 


REST Web Services and model-view-controller 
implementation for web applications 


MVC implementation to be used in a Portlet 
environment 


WebSocket and SockJS implementations, 
including STOMP support 


Spring 的 依赖 以 及 基于 Spring 


虽然 Spring 提供 了 集成 在 一 个 大 范围 的 企业 和 其 他 外 部 工具 的 支持 ， 它 故意 保持 其 强制 性 依 
赖 关 系 降 到 最 低 : 在 简单 的 用 例 里 ， 你 无 需 查找 并 下 载 (甚至 自动 ) 一 大 批 jar 库 来 使 用 
Spring 。 基 本 的 依赖 注入 只 有 一 个 外 部 强制 性 的 依赖 ， 这 是 用 来 做 日 志 的 ( 见 下 面 更 详细 地 
妆 述 日 志 选 项 ) 。 


例 代 码 。Spring 本 身 是 使 用 Gradle 来 管理 依赖 的 ， 我 们 的 很 多 示例 也 是 使 用 Gradle 或 
Maven ° 


译 者 注 : AK Gradle 的 使 用 ， 可 以 参见 笔者 的 另外 一 部 作品 《Gradle 2 用 户 指 南 》 


Maven 依赖 管理 


如 果 您 使 用 的 是 Maven 的 依赖 管理 你 甚至 不 需要 明确 提供 日 志 依 赖 。 例 如 ， 要 创建 一 个 应 用 
程序 的 上 下 文 和 使 用 依赖 注入 来 配置 应 用 程序 ， 你 的 Maven 依赖 将 看 起 来 像 这 样 : 


<dependencies> 
<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-context</artifactId> 
<version>4.3.0.RELEASE</version> 
<scope>runtime</scope> 
</dependency> 
</dependencies> 


就 是 它 。 注 意 scope 可 声明 为 runtime (运行 时 ) 如 果 你 不 需要 编译 Spring API? 24% 
是 基本 的 依赖 注入 使 用 的 案例 。 


以 上 与 Maven Central 存储 库 工程 实例 。 使 用 Spring Maven 存储 库 (如 里 程 碑 或 开发 者 快 
R) ， 你 需要 在 你 的 Maven 配置 指定 的 存储 位 置 。 如 下 : 


<repositories> 
<repository> 
<id>io.spring.repo.maven.release</id> 
<url>http://repo.spring.io/release/</ur1> 
<snapshots><enabled>false</enabled></snapshots> 
</repository> 
</repositories> 


里 程 碑 : 


<repositories> 
<repository> 
<id>io.spring.repo.maven.milestone</id> 
<url>http://repo.spring.io/milestone/</url1> 
<snapshots><enabled>false</enabled></snapshots> 
</repository> 
</repositories> 


以 及 快照 : 


<repositories> 
<repository> 
<id>io.spring.repo.maven. snapshot</id> 
<url>http://repo.spring.io/snapshot/</url> 
<snapshots><enabled>true</enabled></snapshots> 
</repository> 
</repositories> 


Maven "Bill Of Materials" 依赖 


有 可 能 不 小 心 使 用 不 同 版 本 的 Spring JAR 在 使 用 Maven 时 。 例 如 ， 你 可 能 发 现 一 个 第 三 方 
的 库 ， 或 另 一 Spring 的 项 目 ， 拉 取 了 一 个 在 传递 依赖 较 早 的 发 布 包 。 如 果 你 自己 忘记 了 显 式 


声明 一 个 直接 依赖 ， 各 种 意 想不到 的 问题 出 现 。 


为 了 克服 这 些 问 题 ，Maven 支持 "bill of materials" (BOM) 的 依赖 的 概念 。 你 可 以 在 你 的 
dependencyManagement 部 分 引入 spring-framework-bom 来 确保 所 有 spring 依 赖 ( 包括 直 


接 和 传递 的 ) 是 同一 版 本 。 


<dependencyManagement> 
<dependencies> 
<dependency> 
<groupId>org.springframework</groupId> 


<artifactId>spring-framework-bom</artifactId> 


<version>4.3.0.RELEASE</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


使 用 BOM 后 ， 当 依赖 Spring Framework 组 件 后 ， 无 需 指 定 <version> 


<dependencies> 
<dependency> 
<groupiId>org.springframework</groupId> 
<artifactId>spring-context</artifactId> 
</dependency> 
<dependency> 
<groupiId>org.springframework</groupId> 
<artifactId>spring-web</artifactId> 
</dependency> 
<dependencies> 


Gradle 依赖 管理 
用 Gradle 来 使 用 Spring ,在 repositories 中 卉 入 适当 的 URL: 


repositories { 
mavenCentral() 
// and optionally... 
maven { url "http://repo.spring.io/release" } 


可 以 适当 修改 URL 从 /release 到 /milestone 或 /snapshot 。 库 一 旦 配置 ， 就 能 声明 Gradle 
依赖 : 


dependencies { 
compile("org.springframework:spring-context:4.3.0.RELEASE") 
testCompile("org.springframework:spring-test:4.3.0.RELEASE" ) 


lvy 依赖 管理 
如 果 你 更 喜欢 用 lvy 管 理 依赖 包 有 类 似 的 配置 选项 。 


配置 Ivy ， 将 指向 Spring 的 库 添加 下 面 的 resolver (解析 器 ) 到 你 ivysettings.xml : 


<resolvers> 
<ibiblio name="io.spring.repo.maven.release" 
m2compatible="true" 
root="http://repo.spring.io/release/"/> 
</resolvers> 


可 以 适当 修改 root URL 从 /release 到 /milestone 或 /snapshot ° 


一 旦 配置 ， 就 能 添加 依赖 ， 举 例 (在 ivy.xml): 


<dependency org="org.springframework" 
name="Spring-core" rev="4.3.0.RELEASE" conf="compile->runtime"/> 


分 发 的 zip 文件 


虽然 使 用 构建 系统 ， 支 持 依 赖 管理 是 推荐 的 方式 获得 了 Spring Framework,， 它 仍然 是 可 下 载 
分 发 的 zip 文件 。 


分 发 的 zip 文件 是 发 布 到 Spring Maven Repository (这 是 为 了 我 们 的 便利 ， 在 下 载 这 些 文件 
的 时 候 你 不 需要 Maven 或 者 其 他 的 构建 系统 ) 。 


下 载 一 个 Zip， 在 web 浏览 器 打开 http://repo.spring.io/release/org/springframework/spring ° 
选择 适当 的 文件 夹 的 版 本 。 下 载 完 毕 文件 结尾 是 -dist.zip， 例 如 ， spring-framework-{spring- 
version}-RELEASE-dist.zip 。 分 发 也 支持 发 布 里 程 碑 和 快照 。 


日 志 


对 于 Spring 日 志 是 非常 重要 的 依赖 ， 因 为 : a) 它 是 唯一 的 外 部 强制 性 的 依赖 ; b) 每 个 人 都 
喜欢 从 他 们 使 用 的 工具 看 到 一 些 输 出 ; c) Spring 结合 很 多 其 他 工具 都 选择 了 日 志 依 赖 。 应 用 
开发 者 的 一 个 目标 就 是 往往 是 有 统一 的 日 志 配 置 在 一 个 中 心 位 置 为 了 整个 应 用 程序 ， 包 括 所 
有 的 外 部 元 件 。 这 就 更 加 困难 ， 因 为 它 可 能 已 经 有 太 多 选择 的 日 志 框 架 。 


在 Spring 强制 性 的 日 志 依 赖 是 Jakarta Commons Logging API (JCL) 。 我 们 编译 JCL， 我 
们 也 使 得 ICL Log 对 象 对 Spring Framework 的 扩展 类 可 见 。 所 有 版 本 的 Spring 使 用 同样 的 
日 志 库 ， 这 对 于 用 户 来 说 是 很 重要 的 : 迁移 就 会 变 得 容易 向 后 兼容 性 ， 即 使 扩展 Spring 的 应 
用 程序 。 我 们 这 样 做 是 为 了 使 Spring 的 模块 之 一 明确 依赖 commons-logging (JCL 的 典型 实 
现 )， 然 后 使 得 其 他 的 所 有 模块 在 编译 的 时 候 都 依赖 它 。 使 用 Maven 为 例 ， 如 果 你 想 知 道 何 处 
依赖 了 commons-logging ， 那 么 就 是 来 自 Spring 的 并 且 明 确 来 自 中 心 模 块 spring-core。 


关于 commons-logging 的 好 处 是 你 不 需要 任何 东西 就 能 让 你 的 应 用 程序 程序 跑 起 来 。 它 有 一 
个 运行 时 发 现 算 法 ， 该 算法 在 众所周知 的 classpath 路 径 下 寻找 其 他 的 日 志 框 架 并 且 使 用 它 认 
为 适合 的 (或 者 你 可 以 告诉 它 你 需要 的 是 哪 一 个 ) 。 如 果 没 有 其 他 的 日 志 框架 存在 ， 你 可 以 

从 JDK (Java.util.logging 或 者 JUL 的 简称 ) 获得 日 志 。 在 大 多 数 情况 下 ， 你 可 以 在 控制 台 查 
看 你 的 Spring 应 用 程序 工作 和 日 志 ， 并 且 这 是 很 重要 的 。 


不 使 用 Commons Logging 


不 幸 的 是 ，commons-logging 的 运行 时 日 志 框 架 发 现 算法 ， 确 实 方便 了 最 终 用 户 , 但 却 是 有 问 
题 的 。 如 果 我 们 能 够 时 光 倒 流 ， 现 在 从 新 开始 Spring 项 目 并 且 他 使 用 了 不 同 的 日 志 依 赖 。 第 
一 个 选择 很 可 能 是 Simple Logging Facade for Java ( SLF4J)， 过 去 也 曾 被 许多 其 他 工具 通过 
Spring 使 用 到 他 们 的 应 用 程序 。 


主要 有 两 种 方法 可 以 关闭 commons-logging : 


1. 通过 spring-core 模块 排除 依赖 〈 因 为 它 是 唯一 的 显示 依赖 于 commons-logging 的 模 
块 ) 。 

2. 依赖 特殊 的 commons-logging 依赖 ， 用 空 的 jar (更 多 的 细节 可 以 在 SLF4J FAQ 中 找到 ) 
替换 掉 库 。 


排除 commons-logging， 添 加 以 下 的 内 容 到 dependencyManagement 部 分 : 


<dependencies> 
<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>4.3.0.RELEASE</version> 
<exclusions> 
<exclusion> 
<groupId>commons-logging</groupId> 
<artifactId>commons-logging</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
</dependencies> 


现在 ， 这 个 应 用 程序 可 能 运行 不 了 ， 因 为 在 类 路 径 上 没有 实现 JCL API， 因 此 要 修复 它 就 必须 
提供 一 个 新 的 (日 志 框 架 )。 在 下 一 节 我 们 将 向 你 展示 如 何 提供 另 一 种 实现 JCL， 使 用 SLF4J 
作为 例子 的 另 一 种 实现 。 


使 用 SLF4J 


SLF4J 是 一 个 更 加 简洁 的 依赖 ， 在 运行 时 相对 于 commons-logging 更 加 的 有 效 因为 它 使 用 编 
译 时 绑 定 来 代替 运行 时 发 现 其 他 日 志 框架 的 集成 。 这 也 意味 着 ， 你 不 得 不 更 加 明确 你 想 在 运 
行 时 发 生 什 么 ， 并 相应 的 声明 它 或 者 配置 它 。SLF4J 提供 绑 定 很 多 的 常见 日 志 框 架 ， 因 此 你 
可 以 选择 一 个 你 已 经 使 用 的 ， 并 且 绑 定 到 配置 和 管理 。 


SLF4J 提供 了 绑 定 很 多 的 常见 日 志 框 架 ， 包 括 JCL， 它 也 做 了 反 向 工作 :是 其 他 日 志 框 架 和 它 
自己 之 间 的 桥梁 。 因 此 在 Spring 中 使 用 SLF4J 时 ， 你 需要 使 用 SLF4J-JCL 桥接 替换 掉 
commons-logging 的 依赖 。 一 旦 你 这 么 做 了 ，Spring 调用 日 志 就 会 调用 SLF4J API， 因 此 如 
果 在 你 的 应 用 程序 中 的 其 他 库 使 用 这 个 API， 那 么 你 就 需要 有 个 地 方 配置 和 管理 日 志 。 


一 个 常见 的 选择 就 是 桥接 Spring 和 SLF4J， 提 供 显 示 的 绑 定 SLF4J 到 Log4J 上 。 你 需要 支 
持 4 个 的 依赖 〈 排 除 现 有 的 commons-logging) : 桥接 ，SLF4J API， 绑 定 Log4J 和 Log4J 
实现 自身 。 在 Maven 中 你 可 以 这 样 做 : 


<dependencies> 

<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>4.3.0.RELEASE</version> 
<exclusions> 

<exclusion> 
<groupId>commons-logging</groupId> 
<artifactId>commons-logging</artifactId> 
</exclusion> 

</exclusions> 

</dependency> 

<dependency> 
<groupid>org.slf4j</groupId> 
<artifactId>jcl-over-slf4j</artifactId> 
<version>1.5.8</version> 

</dependency> 

<dependency> 
<groupiId>org.slf4j</groupId> 
<artifactId>slf4j-api</artifactId> 
<version>1.5.8</version> 

</dependency> 

<dependency> 
<groupiId>org.slf4j</groupId> 
<artifactId>slf4j-log4j12</artifactId> 
<version>1.5.8</version> 

</dependency> 

<dependency> 
<groupiId>log4j</groupid> 
<artifactId>log4j</artifactId> 
<version>1.2.14</version> 

</dependency> 

</dependencies> 


这 似乎 是 一 个 很 大 的 依赖 性 ， 其 仅仅 是 为 了 得 到 一 些 日 志文 件 。 它 的 确 如 此 ， 但 它 是 可 选 
的 ， 它 在 关于 类 加 载 器 的 问题 上 应 该 比 commons-logging 表现 的 更 加 的 好 ， 特 别 是 当 它 运行 
在 在 一 个 严格 的 容器 中 像 OSGi 平台 。 据 说 还 有 一 个 性 能 优势 是 因为 绑 定 是 在 编译 时 而 不 是 在 
运行 时 。 


对 于 SLF4J 用 户 来 说 ， 一 个 更 常见 的 选择 是 ， 使 用 更 少 的 步骤 和 产生 更 少 的 依赖 ， 那 就 是 直接 
AE Logback。 这 消除 了 多 余 的 绑 定 步 又， 因为 Logback 直接 实现 了 SLF4J， 因 此 你 只 需要 
依赖 两 个 库 而 不 是 4 个 (jcl-over-slf4j 和 logback) 。 如 果 你 这 样 做 ， 你 可 能 还 需要 从 其 他 外 部 
依赖 (不 是 Spring) 排除 slf4j-api 依赖 ， 因 为 在 类 路 径 中 你 只 需要 一 个 版 本 的 API 。 


使 用 Log4J 


许多 人 使 用 Log4j 作为 日 志 ， 用 于 配置 和 管理 的 目的 。 它 是 有 效 的 和 完善 的 ， 事 实 上 这 
也 是 我 们 在 运行 时 使 用 的 ， oe 和 测试 Spring  ° Spring 也 提供 一 些 配置 和 初始 化 
Log4j 的 工具 ， 因 此 在 某 些 模块 上 它 有 一 个 可 选 的 编译 时 依赖 在 Log4j 。 


为 了 使 Log4j 工作 在 默认 的 JCL 依赖 下 (commons-logging) ， 你 所 需要 做 的 就 是 把 Log4j 
放 到 类 路 径 下 ， 为 它 提供 配置 文件 (log4j.properties 或 者 log4j.xml 在 类 路 径 的 根 目 录 下 )。 
此 对 于 Maven 用 户 这 就 是 你 的 依赖 声明 : 


<dependencies> 
<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>4.3.0.RELEASE</version> 
</dependency> 
<dependency> 
<groupiId>1l0g4j</groupid> 
<artifactId>log4j</artifactId> 
<version>1.2.14</version> 
</dependency> 
</dependencies> 


下 面 是 一 个 log4j.properties 的 实例 ， 用 于 将 日 志 打 印 到 控制 台 


log4j.rootCategory=INFO, stdout 
log4j .appender .stdout=org. apache. 1og4j .ConsoleAppender 
log4j .appender.stdout.layout=org.apache.1log4j.PatternLayout 


log4j .appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %t %c{2}:%L - %m%n 


log4j.category.org.springframework.beans. factory=DEBUG 


Runtime Containers with Native JCL 


很 多 的 人 在 提供 ICL 实现 的 容器 下 运行 他 们 的 Spring 应 用 程序 。IBM Websphere 
Application Server WAS) #48 - o pee 问题 ， 遗 憾 的 是 没有 一 个 一 劳 永 逸 的 解决 方 
R ; 仅仅 简单 地 排除 commons-logging 依 赖 在 大 多 数 情况 下 是 不 够 的 。 


要 清楚 这 一 点 : 问题 报告 通常 不 是 at ETA > 或 者 commons-logging : 相反 ， 他 们 是 绑 定 
an nego 到 其 他 的 框架 (通常 是 Log4j ) 。 这 可 能 会 失败 ， 因 为 commons-logging 


改变 了 路 径 ， 当 他 们 运行 ee 器 中 找到 了 老 版 本 (1.0) 并 且 现在 大 多 数 人 使 用 的 
现代 版 本 (1.1)。Spring 不 使 用 JCL API 任何 不 常见 的 模块 ， 所 以 没有 什么 问题 出 现 ， 但 是 很 
快 Spring 或 者 你 的 应 用 程序 视图 做 一 些 日 志 时 ， 你 会 发 现 绑 定 的 Log4j 不 工作 了 。 


在 这 种 情况 下 ，WAS 最 容易 的 是 转化 类 加 载 器 的 层次 结构 (IBM KZA “parent last”) ， 使 应 
用 程序 控制 JCL 的 依赖 关系 ， 而 不 是 容器 。 该 选项 不 是 总 是 开放 的 ， 但 是 有 很 多 其 他 的 建议 
在 公共 领域 的 替代 方法 ， 你 的 里 程 可 能 取决 于 确切 的 版 本 和 特定 的 容器 。 


在 Spring 4.0 新 功能 和 增强 


Spring 框架 第 一 个 版 本 发 布 于 2004 年 ， 自 发 布 以 来 已 历经 三 个 主要 版 本 更 新 : Spring 2.0 提 
BEY XML 命名 空间 和 AspectJ 支持 ; Spring 2.5 增加 了 注释 驱动 (annotation-driven ) 的 配 
置 支 持 ; Spring 3.0 增 加 了 对 Java 5+ 版 本 的 支持 和 @configuration 模型 。 


Spring 4.0 是 最 新 的 主要 版 本 ， 并 且 首 次 完全 支持 Java 8 的 特性 。 你 仍然 可 以 使 用 老 版 本 的 
Java， 但 是 最 低 版 本 的 要 求 已 经 提高 到 Java SE 6。 我 们 也 借 主 要 版 本 更 新 的 机 会 删除 了 许 
多 过 时 的 类 和 方法 。 


你 可 以 在 Spring Framework GitHub Wiki 上 查看 升级 Spring 4.0 的 迁移 指南 。 


改进 的 入 门 体验 


新 的 spring.io 网 站 提供 了 一 整个 系列 的 "入 门 指南 " 帮助 你 学 习 Spring。 你 可 以 本 文档 的 1. 
Getting Started with Spring 一 节 阅 读 更 多 的 入 门 指南 。 新 网 站 还 提供 了 Spring 之 下 其 他 额外 
项 目的 一 个 全 面 的 概述 。 


如 果 你 是 一 个 Maven 用 户 ， 你 可 能 会 对 BOM 这 个 有 用 的 POM 文件 感 兴趣 ， 这 个 文件 已 经 
与 每 个 Spring 的 发 布 版 发 布 。 


移 除 不 推荐 的 包 和 方法 


所 有 过 时 的 包 和 许多 过 时 的 类 和 方法 已 经 从 Spring4 中 移 除 。 如 果 你 从 之 前 的 发 布 版 升级 
Spring， 你 需要 保证 已 经 修复 了 所 有 使 用 过 时 的 API 方 法 。 


查看 完整 的 变化 : APIZHARE © 


请 注意 ， 所 有 可 选 的 第 三 方 依赖 都 已 经 升级 到 了 最 低 2010/2011( 例 如 Spring4 通常 只 支持 
2010 年 的 最 新 或 者 现在 的 最 新 发 布 版 本 ): 尤 其 是 Hibernate 3.6+、EhCache 2.1+ ` Quartz 
1.8+ ` Groovy 1.8+、Joda-Time 2.0+。 但 是 有 一 个 例外 ，Spring4 依 赖 最 近 的 Hibernate 
Validator 4.3+， 现 在 对 Jackson 的 支持 集中 在 2.0+ 版 本 (Spring3.2 % 44 49 Jackson 1.8/1.9， 现 
在 已 经 过 时 ) 。 


Java 8( 以 及 6 和 7) 


Spring4 支持 Java8 的 一 些 特 性 。 你 可 以 在 Spring 的 回调 接口 中 使 用 lambda 表达 式 和 方法 
引用 。 支 持 java.time (JSR-310) 的 值 类 型 和 一 些 改进 过 的 注解 ， 例 如 @Repeatable 。 你 还 
可 以 使 用 Java8 的 参数 名 称 发 现 机 制 (基于 -parameters 编译 器 标志 ) 。 


Spring 仍然 兼容 老 版 本 的 Java 和 JDK : Java SE 6 (HARK > 支持 JDK6 update 18 ) 以 
上 版 本 ， 我 们 建议 新 的 基于 Spring4 的 项 目 使 用 Java7 或 Java8。 


Java EE 6 #7 7 


Java EE 6 或 以 上 版 本 是 Spring4 的 底线 ,与 JPA2.0 和 Servlet3.0 规 范 有 着 特殊 的 意义 。 了 
保持 与 Google App Engine 和 昌 的 应 用 程序 服务 器 兼容 ,Spring4 可 以 部 署 在 Servlet2.5 运 
环境 。 但 是 我 们 强烈 的 建议 您 在 Spring 测试 和 模拟 测试 的 开发 环境 中 使 用 Servlet3.0+。 


如 果 你 是 WebSphere 7 的 用 户 ， 一 定 要 安装 JPA2.0 功 能 包 。 在 WebLogic 10.3.4 或 更 高 版 本 ， 
安装 附带 的 JPA2.0 补 丁 。 这 样 就 可 以 将 这 两 种 服务 器 变 成 Spring4 兼 容 的 部 署 环 境 。 


从 长 远 的 观点 来 看 ，Spring4.0 现在 支持 Java EE 7 级 别 的 适用 性 规范 : 尤其 是 JMS 2.0, JTA 

1.2, JPA 2.1, Bean Validation 1.1 和 JSR-236 并 发 工具 类 。 像 往常 一 样 ， 支 持 的 重点 是 独立 的 

文 些 规范 。 例 如 在 Tomcat 或 者 独立 环境 中 。 但 是 ， 当 把 Spring 应 用 部 署 到 Java EE 7 
务 器 时 它 同样 适用 。 


注意 ，Hibernate 4.3 是 JPA 2.1 的 提供 者 ， 因 此 它 只 支持 Spring4。 同 样 适用 用 于 作为 Bean 
Validation 1.1 提供 者 的 Hibernate Validator 5.0。 这 两 个 都 不 支持 Spring3.2。 


Groovy Bean Definition DSL 


Spring4.0 支持 使 用 Groovy DSL 来 进行 外 部 的 bean 定义 配置 。 这 在 概念 上 类 似 于 使 用 XML 
的 bean 定义 ， 但 是 支持 更 简洁 的 语法 。 使 用 Groovy 还 允许 您 轻松 地 将 bean 定义 直接 谋 入 
到 引导 代码 中 。 例 如 : 


def reader = new GroovyBeanDefinitionReader (myApplicationContext ) 
reader.beans { 
dataSource(BasicDataSource) { 
driverClassName = "org.hsqldb.jdbcDriver" 
url = "jdbc:hsqldb:mem:grailsDB" 
username = "sa" 
password = "" 
settings = [mynew:"setting"] 
} 
sessionFactory(SessionFactory) { 
dataSource = dataSource 
} 
myService(MyService) { 
nestedBean = { AnotherBean bean -> 
dataSource = dataSource 


有 关 更 多 信息 ， 请 参阅 GroovyBeanDefinitionReader javadocs 


核心 容器 改进 


有 几 处 对 核心 容器 的 常规 改进 : 


e Spring 现在 注入 Bean 的 时 候 把 泛 型 类 型 当成 一 种 形式 的 限定 符 。 例 如 : 如 果 你 使 用 S 
pring Data Repository 你 可 以 方便 的 插入 特定 的 实现 : @autowired Repository<Customer> 
customerRepository ° 

。 如果 你 使 用 Spring 的 元 注解 支持 ， 你 现在 可 以 开发 自 定义 注解 来 公开 源 注解 的 特定 属 
性 。 

e 当 自动 装配 到 lists 和 arrays 时 ，Beans 现在 可 以 进行 排序 了 。 支 持 @order 注解 
和 ordered 接口 两 种 方式 。 @Lazy 注解 现在 可 以 用 在 注入 点 以 及 @Bean 定义 上 。 

e 引入 QDescription 注解 ,开发 人 员 可 以 使 用 基于 Java 方式 的 配置 。 

o ARGUE AH ip % Beans 的 广义 模型 通过 @conditional 注解 加 入 。 这 和 @profile 支持 的 类 
似 ， 但 是 允许 以 编程 式 开 发 用 户 定 义 的 策略 。 

© 基于 CGLIB 的 代理 类 不 在 需要 默认 的 构造 方法 。 这 个 支持 是 由 objenesis 库 提供 。 这 个 库 
重新 打包 到 Spring 框架 中 ， 作 为 Spring 框架 的 一 部 分 发 布 。 通 过 这 个 策略 ， 针 对 代理 实 
例 被 调用 没有 构造 可 言 了 。 

o 框架 现在 支持 管理 时 区 。 例 如 Localecontext ° 


常规 Web 改 进 


现在 仍然 可 以 部 署 到 Servlet 2.5 服务 器 ， 但 是 Spring4.0 现在 主要 集中 在 Servlet 3.0+ 环 
境 。 如 果 你 使 用 Spring MVC 测试 框架 ， 你 需要 将 Servlet 3.0 兼容 的 JAR 包 放 到 测试 的 
classpath 下 。 


除了 稍 后 会 提 到 的 WebSocket 支持 外 ， 下 面 的 常规 改进 已 经 加 入 到 Spring 的 Web 模块 : 


e 你 可 以 在 Spring MVC 应 用 中 使 用 新 的 @Restcontroller 注解 ， 不 在 需要 

给 @RequestMapping 的 方法 添加 @ResponseBody 注解 8 

AsyncRestTemplate 类 已 被 添加 进来 ， 当 开发 REST 客户 端 时 ， 人 允许 非 阻塞 异步 支持 。 
e 当 开发 Spring MVC 应 用 时 ，Spring 现 在 提供 了 全 面 的 时 区 支持 。 


WebSocket, SockJS, 和 STOMP 消息 


一 个 新 的 spring-websocket 模块 提供 了 全 面 的 基于 WebSocket 和 在 Web 应 用 的 客户 端 和 服 
务 器 之 间 双 向 通信 的 支持 。 它 和 Java WebSocket API JSR-356 兼容 ， 此 外 还 提供 了 当 浏 览 
器 不 支持 WebSocket 协议 时 (如 Internet Explorer < 10) 的 基于 SockJS 的 备用 选项 (如 
WebSocket emulation) ° 


一 个 新 的 spring-messaging 模块 添加 了 支持 STOMP 作为 WebSocket 子 协 议 用 于 在 应 用 中 使 
用 注解 编程 模型 路 由 和 处 理 从 WebSocket 客户 端 发 送 的 STOMP 消息 。 因 此 @controller 现 
在 可 以 同时 包含 @RequestMapping 和 @MessageMapping 方法 用 于 处 理 HTTP 请 求 和 来 自 
WebSocket 连接 客户 端 发 送 的 消 息 9 新 的 spring-messaging 模块 还 包含 了 来 自 以 前 Spring 集 
成 项 目的 关键 抽象 ， 例 如 Message ` MessageChannel ` MessageHandler FF, 以 此 作为 基于 
消息 传递 的 应 用 程序 的 基础 。 


欲 知 详情 以 及 较 全 面 的 介绍 ， 请 参见 Chapter 20, WebSocket 支持 一 节 。 


测试 改进 


除了 精简 spring-test 模块 中 过 时 的 代码 外 ，Spring 4 还 引入 了 几 个 用 于 单元 测试 和 集成 测试 
的 新 功能 。 


e 几乎 spring-test 模块 中 所 有 的 注解 〈 例 
如 : @ContextConfiguration ` @WebAppConfiguration ` @ContextHierarchy ` @ActivePro 
files 等 等 ) 现 在 可 以 用 作 元 注解 来 创建 自 定义 的 composed annotations 并 且 可 以 减少 测 
试 套件 的 配置 

© 现在 可 以 以 编程 方式 解决 Bean 定 义 配 置 文件 的 激活 。 只 需要 实现 一 个 自 定 义 的 
ActiveProfilesResolver， 并 且 通 过 @ActiveProfiles 的 resolver 属 性 注册 。 

e 新 的 socketutils 类 被 引入 到 了 spring-core 模块 。 这 个 类 可 以 使 你 能 够 扫描 本 地 主机 
的 空闲 的 TCP 和 UDP 服务 端口 。 这 个 功能 不 是 专门 用 在 测试 的 ， 但 是 可 以 证 明 在 你 使 
用 Socket 写 集成 测试 的 时 候 非常 有 用 。 例 如 测试 内 存 中 局 动 的 SMTP 服 务 器 ，FTP 服 务 
器 ，Servlet 容 器 等 。 

e 从 Spring 4.0 开始 ， org.springframework.mock.web 包 中 的 一 套 mock 是 基于 Servlet 3.0 
APl。 此 外 ， 一 些 Servlet API mocks ( 例 
如 : MockHttpServletRequest ` MockServletContext FF) 已 经 有 一 些小 的 改进 更 新 ， 提 
高 了 可 配置 性 


JMS 改进 


Spring 4.1 引入 了 一 个 更 简单 的 基础 架构 ， 使 用 @JmsListener 注解 bean 方法 来 注册 JMS 监 
听 端 点 。XML 命名 空间 已 经 通过 增强 来 支持 这 种 新 的 方式 ( jms:annotation-driven ) ， 它 也 
可 以 完全 通过 Java 配 置 ( @EnableJms , JmsListenerContainerFactory ) 来 配置 架构 。 也 可 以 使 


用 JmsListenerConfigurer 注解 来 注册 监听 端点 2 


Spring 4.1 还 调整 了 JMS 的 支持 ， 使 得 你 可 以 从 spring-messaging 在 Spring4.0 引入 的 抽象 
Ra? Bp: 


。 消息 监听 端点 可 以 有 更 为 灵活 的 签名 ， 并 且 可 以 从 标准 的 消息 注解 获 益 ， 例 
如 @Payload ` @Header ` @Headers 和 人 @ sendTo 注解 。 另 外 ， 也 可 以 使 用 一 个 标准 的 消 
息 ， 以 代替 javax.jms.Message 作为 方法 参数 。 

e 一 个 新 的 可 用 JmsMessageOperations 接口 和 允许 操作 使 用 Message 抽象 
的 JmsTemplate ° 


最 后 ，Spring 4.1 提 供 了 其 他 各 种 各 样 的 改进 : 
e JmsTemplate 中 的 同步 请 求 -答复 操作 支持 
o 监听 器 的 优先 权 可 以 指定 每 个 <jms:listener/> 元 素 


e 消息 侦 听 器 容器 恢复 选项 可 以 通过 使 用 Backoff 实现 进行 配置 
e JMS 2.0 消 费 者 支持 共享 


缓存 改进 


Spring 4.1 支持 JCache (JSR-107) 注 解 使 用 Spring 的 现 有 缓存 配置 和 基础 结构 的 抽象 ; 使 用 
标准 注解 不 需要 任何 更 改 。 


Spring 4.1 也 大 大 提高 了 自己 的 缓存 抽象 : 


© 缓存 可 以 在 运行 时 使 用 cacheResolver 解决 。 因 此 使 用 value 参数 定义 的 缓存 名 称 不 在 是 
强制 性 的 。 

o 更 多 的 操作 级 自 定义 项 : 缓存 解析 器 ， 缓 存 管理 器 ， 键 值 生成 器 

e 一 个 新 的 @cacheconfig 类 级 别 注 解 允 许 在 类 级 别 上 共享 常用 配置 ， 不 需要 局 用 任何 缓存 
操作 。 

e 使 用 cacheErrorHandler 更 好 的 处 理 缓存 方法 的 异常 


Spring 4.1 为 了 在 cacheInterface 添加 一 个 新 的 putIfAbsent 方法 也 做 了 重大 的 更 改 。 


Web 改进 


bd 现 有 的 基于 ResourceHttpRequestHandler 的 资源 处 理 已 经 扩展 了 新 的 抽 
& ResourceResolver ， ResourceTransformer 和 ResourceUrlProvider 。 一 些 内 置 的 实现 
提供 了 版 本 控制 资源 的 URL (有 效 的 HTTP BG) ， 定 位 gzip 压缩 的 资源 ， 产 生 
HTML5 AppCache 清 单 ， 以 及 更 多 的 支持 。 参 见 第 17.16.7 > “Serving of Resources( 服 务 
资源 。 

e JDK 1.8 的 java.util.optional 现在 支 
持 @RequestParam °’ @RequestHeader 和 @MatrixVariable 控制 器 方法 的 参数 2 

e ListenableFuture 支持 作为 返回 和 值 蔡 代 DeferredResult 所 在 的 底层 服务 (或 者 调 
用 AsyncRestTemplate ) 已 经 返回 ListenableFuture ° 

e @Modelattribute 方法 现在 依照 相互 依存 关系 的 顺序 调用 。 见 SPR-6299 。 

e Jackson 的 @JsonView 被 直接 支撑 在 @ResponseBody 和 ResponseEntity 控制 器 方法 用 于 序 
列 化 不 同 的 细节 对 于 相同 的 POJO (如 摘要 与 细节 页 ) 。 同 时 通过 添加 序列 化 视图 类 型 
作为 模型 属性 的 特殊 键 来 支持 基于 视图 的 泻 染 。 见 Jackson Serialization View 
Support(Jackson 序 列 化 视图 支持 ) 

e Jackson 现在 支持 JSONP > I Jackson JSONP Support 

。 一 个 新 的 生命 周期 选项 可 用 于 在 控制 方法 返回 后 ， 响 应 被 写 入 之 前 拦 
截 @ResponseBody 和 ResponseEntity 方法 。 要 充分 利用 声明 @controllerAdvice bean 实 
现 ResponseBodyAdvice ° A @Jsonview 和 JSONP 的 内 置 支持 利用 这 一 优势 。 参 见 第 
17.4.1 > “4% M Handlerinterceptor 拦截 请 求 ”。 

sD 有 三 个 新 的 HttpMessageConverter 选项 : 

o GSON - tt Jackson 更 轻 量 级 的 封装 ;已 经 被 使 用 在 Spring Android 
o oe Protocol Buffers - 高 效 和 有 效 的 企业 内 部 跨 业 务 的 数据 通信 协议 ， 但 也 可 以 
用 于 浏览 器 的 JSON 和 XML ee 
o Jackson 基于 XML 序列 化 ， 现 在 通过 jackson-dataformat-xml 扩展 得 到 了 支持 。 如 
果 jackson-dataformat-xml 在 classpath > RUH IU TAE 
用 @EnablewebMvc 或 <mvc:annotation-driven/> ， 这 是 ， 而 不 是 JAXB2 ° 
。 如 JSP 等 视图 现在 可 以 通过 名 称 参照 控制 器 映射 建立 链接 控制 器 。 默 认 名 称 分 配给 每 一 
AN @RequestMapping ° 例如 Foocontroller 的 方法 与 handleFoo RTA A“FCH 
handleFoo”。 命 名 策略 是 可 插 拔 的 。 另 外 ， 也 可 以 通过 其 名 PA 
的 @RequestMapping ° Æ Spring JSP 标 签 库 的 新 mvcurl 功能 使 这 个 简单 的 JSP 页 面 中 使 
用 。 参 见 第 17.7.2，“Building URIs to Controllers and methods from views” 

© ResponseEntity 提供 了 一 种 builder 风格 的 API 来 指导 控制 器 向 服务 器 端的 响应 的 展示 ， 
例如 ，ResponseEntity.ok()。 

e RequestEntity 是 一 种 新 型 的 ， 提 供 了 一 个 builder 风格 的 API 来 引导 客户 端的 REST "A 
应 HTTP 请 求 的 展示 。 

e MVC 的 Java 配置 和 XML 命名 空间 : 


o 视图 解析 器 现在 可 以 配置 包括 内 容 协商 的 支持 ， 请 参见 17.16.6" 视 图 解析 ”。 
o 视图 控制 器 现在 已 经 内 置 支持 重 定向 和 设置 响应 状态 。 应 用 程序 可 以 使 用 它 来 配置 
重 定向 的 URL，404 视图 的 响应 ， 发 送 "no content 的 响应 ， 等 等 。 有 些 用 例 这 里 列 
出 。 
o 现在 内 置 路 径 匹 配 的 自 定 义 。 参 见 第 17.16.9 ，“ 路 径 匹 配 ”。 
® Groovy 的 标记 模板 支持 (基于 Groovy 的 2.3) o W, GroovyMarkupConfigurer 和 各 自 
的 ViewResolver 和 “视图 ”的 实现 。 


WebSocket STOMP 消息 改进 


e SockJS(Java) 客 户 端 支持 .查看 sockJsclient 和 在 相同 包 下 的 其 他 类 . 

e 发 布 新 的 应 用 上 下 文 实践 SessionSubscribeEvent 和 SessionUnsubscribeEvent ; 用 于 
STOMP 客 户 端的 订阅 和 取消 订阅 . 

e 新 的 "websocket" 级 别 .查看 Section 25.4.14, “WebSocket Scope”. 

© @SendToUser 仅仅 靠 一 个 会 话 就 可 以 命中 ， 而 不 一 定 需要 一 个 授权 的 用 户 . 

© @MessageMapping 方法 使 用 . 来 代替 /作为 目录 分 隔 符 。 查 看 SPR-11660.。 

e STOMP/WebSocket 监听 消息 的 收集 和 记录 。 查 看 25.4.16, “Runtime Monitoring”. ° 

© 显著 优化 和 改善 在 调试 模式 下 依然 保持 日 志 的 可 读 性 和 简洁 性 

o 优化 消息 创建 ， 包 含 对 临时 消息 可 变性 的 支持 和 各 i 
MessageHeaderAccessor 的 java 文 档 9 

。 在 WebSocket 会 话 建立 之 后 的 1 分 钟 没有 任何 活动 , 则 关闭 STOMP/WebSocket 连 接 


测试 改进 


e Groovy 脚 本 现在 能 使 用 Applicationcontext 配置 ， 在 TestContext 框 架 中 整合 测试 。the 
section called “Context configuration with Groovy scripts” 

e 现在 通过 新 的 TestTransaction 接口 ， 使 用 编程 化 来 开始 结束 测试 管理 事务 。the section 
called “Programmatic transaction management” 

© 现在 SQL 脚本 的 执行 可 以 通过 sql 和 sqlconfig 注解 申明 在 每 一 个 类 和 方法 中 。the 
section called “Executing SQL scripts” 

o 测试 属性 值 可 以 通过 配置 @testPropertySource 注解 来 自动 覆盖 系统 和 应 用 的 属性 值 。the 
section called “Context configuration with test property sources” ° 

e 默认 的 TestExecutionListeners 现在 可 以 自动 被 发 现 。the section called “Automatic 
discovery of default TestExecutionListeners” ° 

e 自 定义 的 TestExecutionListeners 现在 可 以 通过 默认 的 监听 器 自动 合并 。the section 
called “Merging TestExecutionListeners” ° 

。 在 TestContext 框 架 中 的 测试 事务 方面 的 文档 已 经 通过 更 多 解释 和 其 他 事例 得 到 改善 。the 
section called “Transaction management” ° 

e MockServletContext ` MockHttpServletRequest 和 其 他 servlet 接 口 mocks 等 诸多 改善 。 

e AssertThrows 重 构 后 ， Throwable 代替 Exception ° 

。 Spring MVC 测 试 中 ， 使 用 JSONPath 选 项 返回 JSON 格 式 可 以 使 用 JSON Assert 来 断言 , 非 
常 像 之 前 的 XML 和 XMLUnit 。 

e MockMvcBuilder 现在 可 以 在 mockmvcConfigurer 的 帮助 下 创建 。 MockMvcconfigurer 的 加 
入 使 得 Spring Security 的 设置 更 加 简单 ， 同 时 使 用 于 任何 第 三 方 的 普通 封装 设置 或 则 仅仅 
在 本 项 目 中 。 


e MockRestServiceServer 现在 支持 AsyncRestTemplate 作为 客户 端 测试 。 


° 发 布 新 的 应 用 上 下 文 实践 SessionSubscribeEvent 和 SessionUnsubscribeEvent ,用 于 
STOMP 客 户 端 的 订阅 和 取消 订阅 . 

e 新 的 "Websocket" 级 别 .查看 [Section 21.4.13, “WebSocket Scope”.] 
(http://docs.spring.io/spring/docs/current/spring-framework- 


核心 容器 改进 


e 如 @bean 注释 ,就 如 同 得 到 发 现 和 处 理 Java 8 默认 方法 一 样 , 可 以 允许 组 合 配 置 类 与 默认 
@bean 接口 方法 。 

。 配置 类 现在 可 以 声明 @import 作为 常规 组 件 类 ,允许 引入 的 配置 类 和 组 件 类 进行 混合 。 

。 配置 类 可 以 声明 一 个 @Order 值 ,用 来 得 到 相应 的 处 理 顺 序 (例如 重 写 bean 的 名 字 )， 即 使 
通过 类 路 径 扫 描 检 测 。 

e @Resource 注入 点 支持 @Lazy 声明 ,类 似 于 @autowired, 用 于 接收 用 于 请 求 目标 bean 
的 懒 初始 化 代理 。 

o 现在 的 应 用 程序 事件 基础 架构 提供 了 一 个 基于 注解 的 模型 以 及 发 布 任意 事件 的 能 力 。 

o 任何 受 管 bean 的 公共 方法 使 用 @EventListener 注解 来 消费 事件 。 

o @TransactionalEventListener 提供 事务 绑 定 事件 支持 。 

e Spring Framework 4.2 引 入 了 一 流 的 支持 声明 和 查找 注释 属性 的 别名 。 新 @AliasFor 注 
解 可 用 于 声明 一 双 别 名 属性 在 一 个 注释 中 或 从 一 个 属性 在 一 个 声明 一 个 别名 定义 注解 在 
元 注释 一 个 属性 组 成 。 

o 下 面 的 注解 已 加 了 @AliasFor 为 了 支持 提供 更 有 意义 的 value 属性 的 别名 : 
@Cacheable, @CacheEvict, @CachePut, @ComponentScan, 
@ComponentScan.Filter, @ImportResource, @Scope, @ManagedResource, 
@Header, @Payload, @SendToUser, @ActiveProfiles, @ContextConfiguration, 
@Sql, @TestExecutionListeners, @TestPropertySource, @Transactional, 
@ControllerAdvice, @CookieValue, @CrossOrigin, @MatrixVariable, 
@RequestHeader, @RequestMapping, @RequestParam, @RequestPart, 
@ResponseStatus, @SessionAttributes, @ActionMapping, @RenderMapping, 
@EventListener, @TransactionalEventListener 

o 4i| 42 > spring-test 的 @ContextConfiguration 现在 声明 如 下 : 


public @interface ContextConfiguration { 


@AliasFor ("locations") 
String[] value() default {}; 


@AliasFor ("value") 
String[] locations() default {}; 


* 同样 ， 组 合 注解 (composed annotations) 从 元 注解 覆盖 的 属性 ,现在 可 以 使 用 @AliasFor 进行 细 粒度 控制 
哪些 属性 是 履 盖 在 一 个 注释 的 层次 结构 。 事 实 上 ,现在 可 以 声明 一 个 别名 给 元 注释 的 Value 属性 。 
* 例如 ， 开 发 一 个 组 合 注解 用 于 一 个 自 定义 的 属性 的 覆盖 


@ContextConfiguration 
public @interface MyTestConfig { 


@AliasFor (annotation = ContextConfiguration.class, attribute = "value") 
String[] xmlFiles(); 


* JL [Spring Annotation Programming Model](http://docs.spring.io/spring/docs/current/sp 
ring-framework-reference/htmlsingle/#annotation-programming-model) 


e 许多 改进 Spring 的 搜索 算法 用 于 寻找 元 注解 。 例 如 ,局 部 声明 组 合 注 解 现在 喜欢 继承 注 
解 。 

© 从 元 注解 覆盖 属性 的 组 合 注解 ， 可 以 被 发 现在 接口 和 abstract, bridge, & interface 方法 就 
像 在 类 ， 标 准 方法 ， 构 造 函 数 ， 和 字段 。 

e Map 表示 的 注解 属性 (和 AnnotationAttributes 实例 ) 可 以 synthesized (合成 ， 即 转换 ) 成 
一 个 注解 。 

o 基于 字段 的 数据 绑 定 的 特点 (DirectFieldAccessor) 与 当前 的 基于 属性 的 数据 绑 定 关联 
(BeanWrapper)。 特 别 是 ,基于 字段 的 绑 定 现在 支持 集合 ,数组 和 Map 的 导航 。 

e DefaultConversionService 现在 提供 开 箱 即 用 的 转化 器 给 Stream, Charset, Currency, 和 
TimeZone. 这 些 转换 器 可 以 独立 的 添加 到 任何 ConversionService 

e DefaultFormattingConversionService 提供 开 箱 即 用 的 支持 JSR-354 的 Money & 
Currency 类 型 (前 提 是 javax.money' API 出 现在 classpath): 这 些 被 命名 为 
MonetaryAmount 和 CurrencyUnit。 支 持 使 用 @NumberFormat 

© @NumberFormat 现在 作为 元 注解 使 用 

e JavaMailSenderlmpl 中 新 的 testConnection() 方法 用 于 检查 与 服务 器 的 连接 

e ScheduledTaskRegistrar 用 于 暴露 调度 的 任务 

e Apache commons-pool2 现在 支持 用 于 AOP CommonsPool2TargetSource 的 池 化 

e 4] A StandardScriptFactory 作为 脚本 化 bean 的 JSR-223 的 基本 机 制 ， 通 过 XML 中 的 

lang:std 元 素 暴露 。 支 持 如 JavaScript 和 JRuby。 (注意 : JRubyScriptFactory 和 
lang:jruby 现在 不 推荐 使 用 了 ,推荐 用 JSR-223 ) 


数据 访问 改进 


e javax.transaction.Transactional 现在 可 以 通过 AspectJ 支持 

e SimpleJdbcCallOperations 现在 支持 命名 绑 定 

e 完全 支持 Hibernate ORM 5.0: 作为 JPA 供应 商 (自动 适 配 ) 和 原生 的 API 一 样 (在 新 的 
org.springframework.orm.hibernate5 包 中 涵盖 了 该 内 容 ) 

o 瞬 入 式 数据 库 可 以 自动 关联 唯一 名 字 ， 并 且 <jdbc:embedded-database> 支持 新 的 
database-name 属性 。 见 下 面 “ 测 试 改进 "内 容 


JMS 改进 


e autoStartup 属性 可 以 通过 JmsListenerContainerFactory 进行 控制 

e 应 答 类 型 Destination 可 以 配置 在 每 个 监听 器 容器 

© @SendTo 的 值 可 以 用 SpEL 表达 式 

e 响应 目的 地 可 以 通过 JmsResponse 在 运行 时 计算 

。 @JmsListener 是 可 以 可 以 重复 的 注解 用 于 声明 多 个 JMS 容器 在 相同 的 方法 上 ( 若 你 还 没 
有 用 上 Java8 请 使 用 新 引入 的 @JmsListeners)。 


Web 改进 


e 支持 HTTP Streaming 和 Server-Sent Events , se IL “HTTP Streaming” 
。 内 建 支持 CORS ， 包 括 全 局 (MVC Java 配置 和 XML 命名 空间 ) 和 本 地 (如 
@CrossOrigin) 配置 。 见 26 章 , CORS 支持 
。 HTTP 缓存 升级 
o 新 的 CacheControl 构建 器 ; 插入 ResponseEntity WebContentGenerator, 
ResourceHttpRequestHandler 
o 改进 的 ETag/Last-Modified 在 WebRequest 中 支持 
© 自 定义 映射 注解 使 用 @RequestMapping 作为 元 数据 注解 
e AbstractHandlerMethodMapping 中 的 public 方法 用 于 运行 时 注册 和 注销 请 求 映射 
e AbstractDispatcherServletlnitializer 中 的 Protected createDispatcherServlet 方法 用 来 进 
一 步 自 定义 DispatcherServlet 实例 
e HandlerMethod 作为 @ExceptionHandler 方 法 的 方法 参数 ,特别 是 方便 
@ControllerAdvice 组 件 
e java.util.concurrent.CompletableFuture 作为 @Controller 方法 返回 值 类 型 
e 字 节 范围 (Byte-range ) 的 请 求 支持 在 HttpHeaders， 用 于 静态 资源 
e @ResponseStatus RMRKEH HR © 
。 # RestTemplate 中 的 UriTemplateHandler 扩展 端点 
o DefaultUriTemplateHandler 暴露 baseUrl 属性 和 路 径 段 的 编码 选项 
o 扩展 端点 可 以 使 用 插入 任何 URI 模板 库 
e OkHTTP 与 RestTemplate 集成 
e 自 定 义 baseUrl 在 MvcUriComponentsBuilder 选择 方法 。 
。 序列 化 / 反 序列 化 异常 消息 现在 记录 为 WARN 级 别 
e 默认 的 JSON 前 级 改变 了 从 ae 改 为 更 安全 的 )]}7， 
e 新 的 RequestBodyAdvice 扩展 点 和 内 置 的 实现 支持 Jackson 的 在 @RequestBody 的 
@JsonView 
e 当 使 用 GSON 或 Jackson 2.6 +, 处 理 程序 方法 的 返回 类 型 是 用 于 提高 参数 化 类 型 的 序列 
化 ， 比 如 List<Foo> 
e 引入 的 ScriptTemplateView 作为 JSR-223 的 脚本 化 web 视图 机 制 为 基础 ,关注 
JavaScript 视图 模板 Nashorn (JDK 8)。 


= 


WebSocket 消息 改进 


。 暴露 展示 信息 关于 用 户 的 连接 和 订阅 : 
o 新 SimpUserRegistry 公开 为 一 个 名 为 "userRegistry” 的 bean ° 
o 共享 在 服务 器 集群 的 展示 信息 ( 见 代理 中 继 配 置 选项 ) 
。 解决 用 户 目的 地 在 集群 的 服务 器 ( 见 代理 中 继 配置 选项 ) 。 
e StompSubProtocolErrorHandler 扩展 端点 用 来 自 定 义 和 控 制 STOMP ERROR MAA P 
。 全 局 @MessageExceptionHandler 方法 通过 @ControllerAdvice 组 件 
e 心跳 和 SpEL 表达 式 'selector 头 用 SimpleBrokerMessageHandler 订阅 
。 STOMP 客户 端 使 用 TCP 和 WebSocket; IL 25.4.13, “STOMP 客户 端 ” 
。 @SendTo 和 @SendToUser 可 以 包含 目标 变量 的 占 位 符 。 Jackson 的 @JsonView 支持 
@MessageMapping 和 @SubscribeMapping 方法 返回 值 
e ListenableFuture 和 CompletableFuture 是 从 @MessageMapping 和 
@SubscribeMapping 方法 返回 类 型 值 
e MarshallingMessageConverter 用 于 XML 有 效 载 荷 


测试 改进 


© AT JUnit 集成 测试 现在 可 以 执行 JUnit 规则 而 不 是 SpringJUnit4ClassRunner。 这 人 允许 
基于 spring 的 集成 测试 与 运行 JUnit 的 Parameterized 或 第 三 方 运行 器 
MockitoJUnitRunner 等 。 详 见 Spring JUnit 规则 

e Spring MVC Test 框架 ， 现 在 支持 第 一 类 HtmlUnit， 包 括 集成 Selenium's WebDriver, 允 
许 基于 页 面 的 Web 应 用 测试 而 无 需 部 署 到 Servlet 容器 。 详 见 14.6.2, “HtmlUnit 集成 ” 

e AopTestUtils 是 一 个 新 的 测试 工具 ， 人 允许 开发 者 获得 潜在 的 目标 对 象 的 引用 隐藏 在 一 个 或 
多 个 Spring 代理 。 详 见 13.2.1, “常见 测试 工具 ” 

e ReflectionTestUtils 现在 支持 ae 和 getting static 字段 ,包括 常量 

e bean 定义 归档 文件 的 原始 顺序 ， 通 过 @ActiveProfiles 声明 ， 现 在 保留 为 了 支持 用 例 尽 
Spring 的 Pali a on: 引导 加 载 配置 文件 基于 活动 归档 文件 的 名 称 。 

。 @DirtiesContext 支持 新 BEFORE_METHOD 
BEFORE_CLASS,BEFORE_EACH TEST METHOD 模式 ， 用 于 测试 之 前 关闭 
ApplicationContext 一 一 例如 ,如 果 一 些 烦人 的 ( 即 ， 有 待 确定 ) 测 试 在 一 个 大 型 测试 套件 的 
ApplicationContext 的 原始 配置 已 经 损坏 。 

© @Commit 是 新 的 注解 直接 可 以 用 来 代替 @Rollback(false) 

e @Rollback 用 来 配置 类 级 别 的 默认 回 滚 语义 

o 因此 ,现在 @TransactionConfiguration 弃 用 ,在 后 续 版 本 将 被 删除 。 

。 @Sql 现在 支持 内 联 SQL 语句 的 执行 通过 一 个 新 的 statements 属性 

e ContextCache 用 于 缓存 测试 之 间 的 ApplicationContext， 而 现在 这 是 一 个 公开 的 API >? 
软 认 的 实现 可 以 替代 自 定 义 的 缓存 需求 

e DefaultTestContext, DefaultBootstrapContext, 和 
DefaultCacheAwareContextLoaderDelegate 现在 是 公开 的 类 ， 支 持 子 包 ， 允 许 自 定义 扩 
展 

e TestContextBootstrapper 现在 负责 构建 TestContext 

。 在 Spring MVC Test 框架 ，MvcResult 详情 可 以 被 日 志 记 录 在 DEBUG 级 别 或 者 写 入 自 
定义 的 OutputStream 或 Writer。 详 见 log(), print(OutputStream), 和 
MockMvcResultHandlers 的 print(Writer) 方法 

e JDBC XML 名 称 空间 支持 一 个 新 的 <jdbc:embedded-database> 的 database-name 属性 ， 
允许 开发 人 员 为 谨 入 式 数 据 库 设置 独特 的 名 字 一 一 例如 ,通过 一 个 SpEL 表达 式 或 前 活动 
bean 定 义 配 置 文件 所 影响 的 占 位 符 属性 

© 谋 入 式 数据 库 现在 可 以 自动 分 配 一 个 唯一 的 名 称 A 的 测试 数据 库 配 置 在 不 同 的 
ApplicationContext 的 测试 套件 中 。 参见 18.8.6" 给 虐 入 式 数 据 库 生成 惟一 名 称 " 的 细节 。 


Spring 4.3 的 新 功能 和 增强 


核心 容器 改进 


。 核心 容器 额外 提供 了 更 丰富 的 元 数据 来 改进 编程 。 

。 默认 Java 8 的 方法 检测 为 bean 属性 的 getter/setter 方法 。 

e 如 果 目 标 bean 只 定义 了 一 个 构造 函数 , 则 它 无 需要 指定 @Autowired 注解 

© @Configuration 类 支持 构造 函数 注入 。 

e 任何 SpEL 表达 式 用 于 指定 @EventListener 的 condition 引用 到 bean ( 例 
如 @beanName.method( ) ) s 

e 组 成 注解 现在 可 以 用 一 个 包含 元 注解 中 的 数组 属性 的 数组 组 件 类 型 的 元 素来 覆盖 。 例 
如 ， @RequestMapping 的 的 String[] path 可 以 在 组 成 注解 用 String path Ba 2 

e @Scheduled 和 @Schedules 现在 是 作为 元 注解 用 来 通过 属性 履 盖 来 创建 自 定 义 的 组 成 注 
解 。 

e @Scheduled 适当 支持 任何 范围 内 的 bean e 


数据 访问 改进 


jdbc:initialize-database 和 jdbc:embedded-database 支持 可 配置 的 分 离 器 被 应 用 到 每 个 脚 
本 。 


缓存 改进 


Spring 4.3 允许 在 一 个 给 定 的 key 并 发 调用 时 实现 要 同步 ， 使 得 相应 的 值 只 计算 一 次 。 这 是 
一 个 可 选 的 功能 ， 通 过 设置 @cacheable 的 新 的 sync 属性 来 启用 。 此 功能 引入 了 cache 接口 
的 一 个 重大 更 改 ， 即 get(Object key, Callable<T> valueLoader ) 方法 已 添加 。 


Spring 4.3 还 改进 了 缓存 抽象 如 下 : 


© SpEL 表达 式 对 于 缓存 相关 的 注解 ， 现 在 可 以 引用 bean (BP @beanname.method()) ) ° 

@ ConcurrentMapCacheManager 和 ConcurrentMapCache 现在 通过 一 个 新 的 storeByValue 属性 
支持 缓存 实体 的 序列 化 ° @Cacheable ， @CacheEvict ? @CachePut 和 @Caching 现在 是 作 
为 元 注解 用 来 通过 属性 履 盖 来 创建 自 定义 的 组 成 注解 。 


JMS 改进 


© @SendTo 现在 可 以 在 类 级 别 间 定 一 个 共同 回复 目标 ° 
© @JmsListener 和 @JmsListeners 现在 是 作为 元 注解 用 来 通过 属性 履 盖 来 创建 自 定义 的 组 
成 注解 。 


Web 改进 


© 内 建 支持 HTTP HEAD 和 HTTP OPTIONS. 
o 新 的 组 合 注解 @GetMapping , @PostMapping , @PutMapping , @DeleteMapping , 和 
@PatchMapping 用 于 @RequestMapping ° 
o 详 见 @RequestMapping 组 合 变种 
e 新 的 @RequestScope , @SessionScope , 和 @ApplicationScope 用 于 web 范围 的 组 合 注解 
o Request scope, Session scope, 和 Application scope 
@ 新 的 @RestControllerAdvice 注解 是 @ControllerAdvice 和 @ResponseBody 的 语义 结合 
© @ResponseStatus 现在 在 类 级 别 被 支持 ， 并 被 所 有 方法 继承 
e 新 的 @sessionAttribute 注解 用 于 访问 session 属性 ( 见 例子 ) 
e 新 的 @RequestAttribute 注解 用 于 访问 请 求 属性 ( 见 例子 ) 
© @ModelAttribute 允许 通过 binding=false 来 避免 数据 绑 定 ( 见 引用 ) 
。 错误 和 自 定义 抛 出 ， 将 被 统一 到 MVC 异常 处 理 器 中 处 理 
© HTTP 消息 转换 编码 一 致 处 理 ， 包 括 默认 UTF-8 用 于 多 部 分 文本 内 容 
o 静态 资源 处 理 使 用 配置 的 contentNegotiationManager 用 于 媒体 类 型 计算 
@ RestTemplate 和 AsyncRestTemplate 支持 通过 DefaultUriTemplateHandler 来 实现 严格 
的 URI 变 量 编码 
@ AsyncRestTemplate 支持 请 求 拦截 


WebSocket 消息 改进 


@SendTo 和 @SendToUser 现在 可 以 在 类 级 被 指 定 为 共享 共 同 的 目 的 地 。 


测试 改进 


。 为 了 支持 Spring TestContext Framework ， 现 在 需要 JUnit 4.12 或 者 更 高 的 版 本 

e 新 的 SpringRunner 关联 于 SpringJUnit4ClassRunner 

。 测试 相关 的 注解 ， 现 在 可 以 在 接口 上 声明 了 。 例 如 ， 基 于 Java 8 的 接口 上 使 用 测试 接口 

e 空 声明 的 @contextconfiguration 现在 将 会 完全 忽略 ， 如 果 检 测 到 默认 的 XML ULF, 
Groovy 脚本 ， 或 @Configuration RA 

e @Transactional 测试 方法 不 再 需要 public (如 ,在 TestNG 和 JUnit 5) 

© @BeforeTransaction 和 @AfterTransaction 不 再 需要 public ， 并 且 在 基于 Java 8 的 接 
口 的 默认 方法 上 声明 


e 在 Spring TestContext Framework 的 applicationcontext 的 缓存 现在 有 界 为 32 默 认 最 大 
规模 和 最 近 最 少 使 用 驱逐 策略 。 最 大 的 大 小 可 以 通过 设置 称 
为 spring.test.context.cache.maxSize 一 个 JVM 系统 属性 或 Spring 配置 。 

e ContextCustomizer API 用 于 自 定 义 测试 Applicationcontext 在 bean 定义 加 载 到 上 下 
文 后 但 在 上 下 文 被 刷新 前 。 定 制 工具 可 以 在 全 球 范围 由 第 三 方 进行 注册 ， 而 无 需要 实现 
一 个 自 定义 的 contextLoader ° 

© @Sql 和 @SqlGroup 现在 作为 元 注解 通过 和 才 盖 属性 来 创建 自 定 义 组 合 注 解 

e ReflectionTestUtils 现在 在 set 或 get 一 个 字段 时 ， 会 自动 解 开 代理 。 

e 服务 器 端的 Spring MVC 测试 支持 具有 多 个 值 的 响应 头 。 

e 服务 器 端的 Spring MVC 测试 解析 表单 数据 的 请 求 内 容 和 填充 请 求 参数 。 

e 服务 器 端的 Spring MVC 测试 支持 mock 式 的 断言 来 调用 处 理 程序 方法 。 

e 客户 端 REST 测试 支持 允许 指定 多 少 次 预期 的 请 求 以 及 期 望 的 声明 顺序 是 否 应 该 被 忽略 

(参见 15.6.3，“ 客 户 端 REST 测 试 ") 。 
。 客户 端 REST 测试 支持 请 求 主体 表单 数据 的 预期 。 


支持 新 的 类 库 和 服务 器 


e Hibernate ORM 5.2 (同样 很 好 的 支持 4.2/4.3 和 5.0/5.1， 不 推荐 3.6 ) 
e Jackson 2.8 (在 Spring 4.3， 最 低 至 Jackson 2.6+ ) 

© OkHttp 3.x (仍然 并 行 支持 OkHttp 2.x) 

e Netty 4.1 

e Undertow 1.4 

e Tomcat 8.5.2 以 及 9.0 M6 


Part Ill. 核心 技术 


该 部 分 的 参考 文档 涵盖 了 Spring Framework 中 所 有 绝对 不 可 或 缺 的 技术 。 


这 其 中 最 重要 的 部 分 就 是 Spring Framework 中 的 控制 反 转 (loC) 容 器 。Spring Framework? 
loC 容 器 是 紧 随 着 Spring 中 面向 切面 编程 (AOP) 技 术 的 全 面 应 用 的 来 完整 实现 的 。Spring 
Framework 有 它 自己 的 一 套 AOP 框 架 ， 这 套 框 架 从 概念 上 很 容易 理解 ， 而 且 成 功 解决 了 Java 
企业 级 应 用 中 AOP 需 求 80% 的 核心 要 素 。 


同样 Spring 与 AspectJ 的 集成 (目前 从 功能 上 来 说 是 最 丰富 ， 而 且 也 无 疑 是 Java 企 业 领域 最 成 
熟 的 AOP 实 现 ) 也 涵盖 在 内 。 


e Chapter 6, loC 容 器 

e Chapter 7, 资源 

© Chapter 8, 验证 ， 数 据 绑 定 和 类 型 转换 
e Chapter 9, Spring 表达 式 语言 (SpEL) 
e Chapter 10, Spring 中 的 面向 切面 编程 

e Chapter 11, Spring AOP API 


介绍 Spring loC *& 4 f bean 


本 章 涵盖 了 Spring Framework 中 控制 反 转 原则 (loC) 的 实现 。loC 也 就 是 被 大 家 所 熟知 的 
依赖 注入 (DI) 。 他 是 一 个 对 象 定义 他 的 依赖 的 一 个 过 程 ， 所 谓 依赖 ， 就 是 和 它 一 起 工作 的 
对 象 ， 这 个 过 程 只 能 通过 构造 函数 的 参数 ， 工 厂 方法 的 参数 ， 或 者 已 经 被 构造 或 者 从 工厂 方 
法 返回 的 对 象 的 setter 方法 设置 其 属性 来 实现 。 接 着 容器 在 创建 Bean 后 注入 这 些 依赖 。 这 个 
过 程 从 根本 上 来 讲 是 反 向 的 ， 由 于 bean 自 己 控制 实例 ， 或 者 直接 通过 类 的 结构 ， 类 似 于 
Service Locator 模式 来 定位 他 的 依赖 。 


org.springframework.beans 和 org.springframework.context 包 是 Spring Framework 的 loC 
容器 的 根本 。BeanFactory 接口 提供 了 一 种 更 先进 的 配置 机 制 来 管理 任意 类 型 的 对 象 。 
ApplicationContext 是 BeanFactory 的 一 个 子 接口 。ApplicationContext 使 得 和 Spring 的 
AOP 功能 集成 变 得 更 简单 ; 添加 了 信息 资源 处 理 (国际 化 中 使 用 ) ， 事 件 发 布 ; 还 添加 了 应 
用 程序 层 的 特殊 上 下 文 ， 如 用 于 web 应 用 程序 的 WebApplicationContext ° 


简 而 言 之 ，BeanFactory 提 供 了 配置 框架 和 基本 功能 ， 而 ApplicationContext 添加 了 更 多 企业 
应 用 功能 。ApplicationContext 完 整 扩展 了 BeanFactory, 这 些 内 容 在 介绍 Spring 的 loC 容 器 的 章 
节 里 面 会 专门 讲 到 。 更 多 使 用 BeanFactory 请 参阅 章节 6.16, “The BeanFactory”. 


在 Spring 中 ， 由 Spring loC 容 器 管理 的 ， 构 成 你 的 程序 骨架 的 这 些 对 象 叫 做 bean。 bean 对 象 
是 指 经 过 loC 容 器 实例 化 ， 组 装 和 管理 的 对 象 。 此 外 ，bean 就 是 你 应 用 程序 中 诸多 对 象 之 
一 。bean 和 bean 的 依赖 被 容器 所 使 用 的 配置 元 数据 所 反射 。 
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org.springframework.context. Ajar Dipi 代表 Spring loC 容器 ， 并 负责 实例 化 ， 配 置 
和 组 装 上 述 bean 的 接口 。 容 器 过 对 象 实例 化 ， 配 置 ， 和 和 读 取 配 置 元 数据 汇编 导 到 对 象 的 
构建 。 配 置 元 数据 可 以 是 用 XML” Java 注解 ， 或 Java 代码 来 展示 。 它 可 以 让 你 描述 组 成 应 
用 程序 的 对 象 和 对 象 间 丰 富 的 相互 依赖 。 


Spring ApplicationContext 接口 提供 了 几 种 即 装 即 用 的 实现 方式 。 在 独立 应 用 中 ， 通 常 以 创建 
ClassPathXmlApplicationContext 或 FileSystemXmlApplicationContext 的 实例 。 虽 然 XML 一 
直 是 传统 的 格式 来 定义 配置 元 数据 ， 但 也 可 以 指示 容器 使 用 Java 注解 或 代码 作为 元 数据 格 
式 ， 并 通过 提供 少量 的 XML 配置 以 声明 方式 启用 这 些 额 外 的 元 数据 格式 的 支持 。 


在 大 多 数 应 用 场合 ， 不 需要 明确 的 用 户 代 码 来 实例 化 一 个 Spring loC 容器 的 一 个 或 多 个 实 

例 。 例 如 ， 在 web 应 用 程序 中 ， 在 应 用 程序 的 web.xml 文 件 中 一 个 简单 的 样板 网 站 的 XML 描 
述 符 通常 就 足够 了 ( 见 第 6.15.4，“ 便 捷 的 ApplicationContext 实例 化 Web 应 用 程序 ") 。 如 果 
您 使 用 的 是 基于 Eclipse 的 Spring Tool Suite 开 发 环境 ， 该 样板 配置 可 以 很 容易 地 用 点 击 几 下 
鼠标 或 键盘 创建 。 


下 面 的 图 展示 了 Spring 是 如 何 工作 的 高 级 视图 。 您 的 应 用 程序 的 类 与 配置 元 数据 进行 结合 ， 
以 便 在 ApplicationContext 创 建 和 初始 化 后 ， 你 有 一 个 完全 配置 和 可 执行 的 ee 程序 。 


Figure 6.1. The Spring loC container 


配置 元 数据 


如 上 述 图 所 示 ，Spring loC 容器 使 用 配置 元 数据 ( configuration metadata) ;这 个 配置 元 数 
据 代 表 了 应 用 程序 开发 人 员 告 诉 Spring 容器 在 应 用 程序 中 如 何 来 实例 化 ， 配 置 和 组 装 对 象 。 


传统 的 配置 元 数据 是 一 个 简单 而 直观 的 XML 格式， 这 是 大 多 数 本 章 用 来 传达 关键 概念 和 
Spring loC 容器 的 功能 。 


基于 XML 的 元 数据 并 不 是 配置 元 数据 的 唯一 允许 的 形式 。 Spring /oC 容 器 本 身 是 完全 与 配置 
元 数据 的 实际 写 入 格式 分 离 的 。 现 在 ， 许 多 开发 人 员 选 择 基 于 Java 的 配置 。 来 开发 他 们 的 应 
用 程序 


更 多 其 他 格式 的 元 数据 见 


e 基于 注解 的 配置 : Spring 2.5 的 推出 了 基于 注解 的 配置 元 数据 支持 。 

e 基于 Java 的 配置 : Spring3.0 开始 ， 由 Spring JavaConfig 项 目 提供 了 很 多 功能 成 为 核心 
Spring 框架 的 一 部 分 。 因 此 ， 你 可 以 通过 使 用 Java， 而 不 是 XML 文件 中 定义 外 部 bean 
到 你 的 应 用 程序 类 。 要 使 用 这 些 新 功能 ， 请 参阅 @Configuration，@Bean，@Import 和 


@DependsOn 注解 。 


Spring 配置 至 少 一 个 ， 通 常 不 止 一 个 bean 由 容器 来 管理 。 基 于 XML is 元 数据 将 这 
bean 配置 为 <bean/> 元 素 ， 并 放置 到 <bean/> 元 素 内 部 。 Java 配置 通常 在 
@configuration 注解 的 类 中 使 用 @Bean 注解 到 方法 上 。 


这 些 bean 定义 对 应 于 构成 应 用 程序 的 实际 对 象 。 通 常 ， 您 定义 服务 层 对 象 ， 数 据 访 问 对 象 
(DAO) ， 展 示 对 象 ， 如 Struts Action 的 情况 下 ， 基 础 设施 的 对 象 ， 如 Hibernate 的 
aan > JMS Queues， 等 等 。 通 常 一 个 不 配置 细 粒 度 域 对 象 在 容器 中 ， 因 为 它 通 
责 DAO 和 业务 逻辑 来 创建 和 负载 域 对 象 。 但 是 ， 你 可 以 使 用 Spring 和 AspectJ 的 集成 
loC 容器 的 控制 之 外 创建 的 对 象 。 请 参阅 使 用 Aspects 在 Spring 中 进行 依赖 关系 注入 
ee o 


以 下 示例 显示 基于 XML 的 配置 元 数据 的 基本 结构 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="..." class="..."> 
<!-- collaborators and configuration for this bean go here --> 
</bean> 
<bean id="..." class="..."> 
<!-- collaborators and configuration for this bean go here --> 
</bean> 
<!-- more bean definitions go here --> 
</beans> 


id 属性 是 一 个 字符 串 ， 唯 一 识别 一 个 独立 的 bean 定义 。class 属性 定义 了 bean HRB > # 
使 用 完整 的 类 名 。 id 属性 的 值 是 指 协作 对 象 。 将 XML 用 于 参照 协作 对 象 未 在 本 例 中 示 出 ;请 参 
阅 依赖 以 获取 更 多 信息 。 


实例 化 容器 


实例 化 Spring loC 容器 是 直截了当 的 。 提 供给 ApplicationContext 构 造 器 的 路 径 就 是 实际 的 资 
源 字 符 串 ， 使 容器 装 入 从 各 种 外 部 资源 的 配置 元 数据 ， 如 本 地 文件 系统 ，Java 
CLASSPATH， 等 等 。 


ApplicationContext context = 
new ClassPathxXmlApplicationContext(new String[] {"Services.xml", "daos.xml"}); 


44% T AF Spring 的 loC 容器 ， 你 可 能 想 知 道 更 多 关于 Spring “Resource 抽象 ， 如 第 7 章 ， 
资源 ， 它 提供 了 一 种 方便 的 从 一 个 URI 语法 定义 的 位 置 读 取 一 个 InputStream 描述 。 特 别 
地 ， 资 源 路 径 被 用 作 构 建 应 用 程序 的 上 下 文 ， 详 见 第 7.7 节 ，“ 应 用 环境 和 资源 的 路 径 ”。 


下 面 的 例子 显示 了 服务 层 对 象 (services.xml 中 ) 配置 文件 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www. springframework.org/schema/beans" 
xmLlns:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 


<!-- services --> 


<bean id="petStore" class="org.springframework.samples.jpetstore.services.PetStore 
ServiceImp1"> 
<property name="accountDao" ref="accountDao"/> 
<property name="itemDao" ref="itemDao"/> 
<!-- additional collaborators and configuration for this bean go here --> 
</bean> 


<!-- more bean definitions for services go here --> 


</beans> 


下 面 的 例子 显示 了 数据 访问 对 象 daos.xml 文件 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="accountDao" 
class="org.springframework.samples.jpetstore.dao.jpa. JpaAccountDao"> 
<!-- additional collaborators and configuration for this bean go here --> 
</bean> 


<bean id="itemDao" class="org.springframework.samples.jpetstore.dao.jpa.JpaItemDao 
"> 
<!-- additional collaborators and configuration for this bean go here --> 
</bean> 


<!-- more bean definitions for data access objects go here --> 


</beans> 


在 上 面 的 例子 中 ， 服 务 层 由 类 PetStoreServicelmpl， 以 及 类 型 的 两 个 数据 访问 对 象 
JpaAccountDao 和 JpaltemDao (基于 JPA 对 象 /关系 映射 标准 ) 组 成 。property name 元 素 是 
指 JavaBean 属性 的 名 称 ， 而 ref 元 素 引 用 另 一 个 bean 定义 的 名 称 。id 和 ref 元 素 之 间 的 这 
种 联系 表达 了 合作 对 象 之 间 的 依赖 关系 。 对 于 配置 对 象 的 依赖 关系 的 详细 信息 ， 请 参阅 依 

$h o 


撰写 基于 XML 的 配置 元 数据 


它 可 以 让 bean 定义 跨越 多 个 XML 文件, 这样 做 非常 有 有 用。 通常 ， 每 个 单独 的 XML 配置 文件 
代表 你 的 架构 一 个 逻辑 层 或 模块 。 


您 可 以 使 用 应 用 程序 上 下 文 构造 从 所 有 这 些 XML 片段 加 载 bean 定义 。 这 个 构造 函数 的 多 个 
Resource 位 置 ， 作 为 上 一 节 中 被 证 明 。 另 外 ， 使 用 <import/> 元 素 的 一 个 或 多 个 出 现 ， 从 另 
一 个 或 多 个 文件 加 载 bean 定义 。 例如 : 


<beans> 
<import resource="services.xmLl"/> 
<import resource="resources/messageSource.xmLl"/> 
<import resource="/resources/themeSource. xml"/> 


<bean id="beani" class="..."/> 
<bean id="bean2" class="..."/> 
</beans> 


上 面 的 例子 中 ， 使 用 了 3 个 文件 : services.xml > messageSource.xml 及 themeSource.xml # 
加 载 外 部 bean 定义 。 所 有 位 置 路 径 是 相对 于 导入 文件 的 ， 因 此 services.xml 是 必须 和 导入 文 
件 在 同一 目录 或 类 路 径 中 的 位 置 ， 而 messageSource.xml 和 themeSource.xml 来 必须 在 寻 
入 文件 的 resources 以 下 位 置 。 正 如 你 所 看 到 的 ， 前 面 的 斜 线 被 忽略 ， 但 考虑 到 这 些 路 径 是 
相对 的 ， 它 更 好 的 形式 是 不 使 用 斜 线 。 该 文件 的 内 容 被 导入 ， 包 括 顶 级 <beans /> TH? wl 
须根 据 Spring Schema 是 有 效 的 XML bean 定义 。 


这 是 可 能 的 ， 但 不 推荐 ， 引 用 在 使 用 相对 “.[ 的 路 径 的 父 目 录 中 的 文件 。 这 样 将 创建 一 个 文 

件 ， 该 文件 是 当前 应 用 程序 之 外 的 依赖 。 特 别 是 ， 该 引用 不 推荐 %lasspa 妨 : ” URL (4) 

te > “classpath:../services.xml”) ， 在 运行 时 解决 过 程 中 选择 了 “就 近 ” 的 类 路 径 的 根 ， 然 后 查 

找到 它 的 父 目 录 。 类 路 径 配 置 的 变化 可 能 导致 不 同 的 ， 不 正确 的 目录 的 选择 。 您 可 以 随时 使 
完全 合格 的 资源 位 置 ， 而 不 是 相对 路 径 : 例如 ，file:C:/config/services.xml" 或 

EC X1m/"。 但 是 ， 要 知道 ， 你 这 是 是 在 耦合 应 用 程序 的 配置 到 特定 的 绝 

对 位 置 。 通 常 优 选 问 接 的 方式 应 对 这 种 绝对 路 径 ， 例 如 ， 通 过 吗 f ,在 运行 时 解决 了 对 JVM 系 

统 属 性 占 位 符 。 


使 用 容器 


ApplicationContext 是 能 够 保持 bean 定义 以 及 相互 依赖 关系 的 高 级 工厂 接口 。 使 用 方法 下 
getBean(String name, Class requiredType) 就 可 以 取得 bean 的 实例 。 


ApplicationContext 中 可 以 读 取 bean 定义 并 访问 它们 ， 如 下 所 示 : 


// create and configure beans 
ApplicationContext context = 
new ClassPathxXmlApplicationContext(new String[] {"Services.xml", "daos.xml"}); 


// retrieve configured instance 


PetStoreService service = context.getBean("petStore", PetStoreService.class); 


// use configured instance 
List<String> userList = service.getUsernameList(); 


您 可 以 使 用 getBean() 方法 来 获取 bean 的 实例 。 ApplicationContext 接口 有 一 些 其 他 的 方法 
来 获取 bean， 但 理想 的 应 用 程序 代码 不 应 该 使 用 它们 。 事 实 上 ， 你 的 应 用 程序 代码 不 应 该 调 
用 的 getBean() 方法 ， 因 此 在 Spring 的 API 没有 依赖 性 的 。 例 如 ，Spring 如 何 与 Web 框 架 的 

集成 提供 了 依赖 注入 各 种 Web 框 架 类 ， 如 控制 器 和 JSF 管理 的 bean。 


Spring loC 容易 管理 一 个 或 者 多 个 bean’ bean 由 应 用 到 到 容器 的 配置 元 数据 创建 ,例如 ,在 
XML 中 定义 <bean/> 的 形式 。 


容器 内 部 ,这 些 bean 定义 表示 为 BeanDefinition 对 象 , 其 中 包含 (其 他 信息 ) 以 下 元 数据 : 


。 限定 包 类 名 称 : 典 型 的 实际 实现 是 定义 bean 的 类 。 

e bean 行为 配置 元 素 ,定义 了 容器 中 的 Bean 应 该 如 何 行为 (范围 、 生 命 周 期 回调 ,等 等 )。 

e bean 需要 引用 其 他 bean 来 完成 工作 ,这 些 引 用 也 称 为 合作 者 或 依赖 关系 。 

eo 其 他 配置 设置 来 设置 新 创建 的 对 象 ,例如 ,连接 使 用 bean 的 数量 管理 连接 池 , 或 者 池 的 大 小 
限制 。 


以 下 是 每 个 bean 定义 的 属性 


Table 6.1. The bean definition 


属性 解释 
class Section 6.3.2, “Instantiating beans” 
name Section 6.3.1, “Naming beans” 
scope Section 6.5, “Bean scopes” 
constructor arguments Section 6.4.1, “Dependency Injection” 
properties Section 6.4.1, “Dependency Injection” 
autowiring mode Section 6.4.5, “Autowiring collaborators” 
lazy-initialization mode Section 6.4.4, “Lazy-initialized beans” 
initialization method the section called “Initialization callbacks” 
destruction method the section called “Destruction callbacks” 


包含 的 信息 里 面 bean 定义 的 如 何 创 F ApplicationContext 的 实现 还 允 
- 用 户 注 册 现 有 创建 在 容器 之 外 的 现 有 对 象 。 通过 访问 ApplicationContext 的 
BeanFactory 的 getBeanFactory() 方法 返回 See 的 实现 
DefaultListableBeanFactory 。DefaultListableBeanFactory 支持 这 种 通过 
registerSingleton(..) 和 registerBeanDefinition(..) 方法 来 注册 。 然 而 ,典型 的 应 用 程序 只 能 通过 
元 数据 定义 的 bean 来 定义 。 


需要 尽早 注册 Bean 元 数据 和 手动 使 用 单 例 的 实例 ,这 是 为 了 使 容器 正确 推断 它们 在 自动 

和 其 他 内 省 的 步 又。 虽然 覆盖 现 有 的 元 数据 和 现 有 的 单 例 实 例 在 某 种 程度 上 是 支持 的 ， bean 
在 运行 时 (同时 动态 访问 工厂 ) 注 册 不 是 官方 支持 ,可 能 会 导致 并 发 访问 bean 容器 中 的 异常 和 / 
或 不 一 致 的 状态 。 


ay % bean 


每 个 bean 都 有 一 个 或 多 个 标识 符 。 这 些 标识 符 在 容器 托管 bean 必须 是 唯一 的 。bean 通常 
只 有 一 个 标识 符 , 但 如 果 它 需要 不 止 一 个 ,可 以 考虑 额外 的 别名 。 


在 基于 xml 的 配置 中 ,您 可 以 使 用 id 和 (或 ) 名 称 属 性 指定 bean 标识 符 。(id 属性 允许 您 指定 一 
个 id。 通 常 这 些 名 字 使 用 字母 数字 (“myBean”、“fooService”, 等 等 ), 但 可 以 包含 特殊 字符 。 如 

果 你 想 使 用 bean 别 名 ,您 可 以 在 name 属性 上 定义 它们 ,由 去 号 (,), 分 号 (:), 或 白色 宝 格 进行 分 隔 。 
作为 一 个 历史 因素 的 要 注意 ,在 Spring 3.1 版 本 之 前 ,id 属性 被 定义 为 xsd:ID 类 型 , 它 限 制 可 能 

的 字符 。3.1, 它 被 定义 为 一 个 xsd:string 类 型 。 注 意 ,bean id 独特 性 仍 由 容器 执行 ,虽然 不 再 由 
XML 解析 器 。 


你 不 需要 提供 一 个 bean 的 名 称 或 id。 如 果 没 有 显 式 地 提供 名 称 或 id, 容器 生成 一 个 唯一 的 名 称 
给 bean 。 然 而 ,如 果 你 想 引 用 bean 的 名 字 , 通 过 使 用 ref 元 素 或 使 用 Service Locator (服务 
定位 器 ) 风格 查找 ,你 必须 提供 一 个 名 称 。 不 使 用 名 称 的 原因 是 ， 内 部 bean 和 自动 装配 的 合 
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bean 名 约定 


约定 是 使 用 标准 Java 实例 字段 名 称 命名 bean 时 的 约定 。 也 就 是 说 ,bean 名 称 开 始 以 小 写字 
母 开 头 ,后 面 采 用 “ 骆 峰 式 ”。 例 
+ “accountManager” ` “accountService’, ‘userDao’, loginController’, + * ° 


一 致 的 beans 命 名 可 以 让 您 的 配置 容易 阅读 和 理解 ， 如 果 你 正在 使 用 Spring AOP， 当 你 通过 
bean 名 称 应 用 到 advice 时 ， 这 会 对 你 帮助 很 大 。 


bean 的 别名 


在 对 bean 定义 时 ， 除 了 使 用 id 属性 指定 一 个 唯一 的 名 称 外 ， 为 了 提供 多 个 名 称 ， 需 要 通过 
name 属性 加 以 指定 ， 所 有 这 个 名 称 都 指向 同一 个 bean， 在 某 些 情况 下 提供 别名 非常 有 用 ， 
比如 为 了 让 应 用 每 一 个 组 件 都 能 更 容易 的 对 公共 组 件 进行 引用 。 然 而 ， 在 定义 bean 时 就 指定 
所 有 的 别名 并 不 总 是 很 恰当 。 有 时 我 们 期 望 能 够 在 当前 位 置 为 那些 在 别处 定义 的 bean 引 入 别 
名 。 在 XML 配置 文件 中 ， 可 以 通过 <alias/> 元 素来 完成 bean 别名 的 定义 ， 例 如 : 


<alias name="fromName" alias="toName"/> 


上 面 示例 中 ， 在 同一 个 容器 中 名 为 fomName 的 bean 定义， 在 增加 别名 定义 后 ， 也 可 以 用 
toName 来 引用 。 


例如 ， 在 子 系统 A 中 通过 名 字 subsystemA-dataSource 配置 的 数据 源 。 在 子 系统 B 中 可 能 通 
过 名 字 subsystemB-dataSource 来 引用 。 当 两 个 子 系统 构成 主 应 用 的 时 候 ， 主 应 用 可 能 通过 
名 字 myApp-dataSource 引用 数据 源 ， 将 全 部 三 个 名 字 引 用 同一 个 对 象 ， 你 可 以 将 下 面 的 别 

名 定义 添加 到 应 用 配置 中 : 


<alias name="subsystemA-dataSource" alias="sSubsystemB-dataSource"/> 
<alias name="subsystemA-dataSource" alias="myApp-dataSource" /> 


现在 每 个 子 系统 和 主 应 用 都 可 以 通过 唯一 的 名 称 来 引用 相同 的 数据 源 ， 并 且 可 以 保证 他 们 的 
定义 不 与 任何 其 他 的 定义 冲突 。 


基于 Java 的 配置 


如 果 你 想 使 用 基于 Java 的 配置 ，@Bean 注解 可 以 用 来 提供 别名 ， 详 细 信 息 请 看 Section 
6.12.3, “Using the @Bean annotation” 


实例 化 bean 


bean 定义 基本 上 就 是 用 来 创建 一 个 或 多 个 对 象 的 配置 ， 当 需要 一 个 bean 的 时 候 ， 容 器 查看 
配置 并 且 根 据 bean 定义 封装 的 配置 元 数据 创建 (或 获取 ) 一 个 实际 的 对 象 。 


如 果 你 使 用 基于 XML 的 配置 ， 你 可 以 在 <bean/> 元 素 通 过 class 属性 来 指定 对 象 的 类 型 。 这 
个 class 属性 ， 实 际 上 是 BeanDefinition 实例 中 的 一 个 Class 属性 。 这 个 class 属性 通常 是 必 
须 的 (例外 情况 ， 查 看 “使 用 实例 工厂 方法 实例 化 ” 章节 和 Section 6.7, "Bean 定义 的 继 

AR”) ， 使 用 Class 属性 的 两 种 方式 : 


。 通常 情况 下 ， 直 接 通过 反射 调用 构造 方法 来 创建 bean， 和 在 Java 代码 中 使 用 new 有 点 
像 。 

o 通过 静态 工厂 方法 创建 ， 类 中 包含 静态 方法 。 通 过 调用 静态 方法 返回 对 象 的 类 型 可 能 和 
Class 一 样 ， 也 可 能 完全 不 一 样 。 


内 部 类 名 。 如 果 你 想 配置 使 用 静态 的 内 部 类 ， 你 必须 用 内 部 类 的 二 进 制 名 称 。 例 如 ， 在 
com.example 包 下 有 个 Foo 类 ， 这 里 类 里 面 有 个 静态 的 内 部 类 Bar， 这 种 情况 下 bean 定 义 的 
class% tt 2 %K...com.example.Foo$Bar 注意 ， 使 用 8 字符 来 分 割 外 部 类 和 内 部 类 的 名 称 。 


通过 构造 函数 实例 化 


当 你 使 用 构造 方法 来 创建 bean 的 时 候 ，Spring 对 类 来 说 并 没有 什么 特殊 。 也 就 是 说 ， 正 在 
开发 的 类 不 需要 实现 任何 特定 的 接口 或 者 以 特定 的 方式 进行 编码 。 但 是 ， 根 据 你 使 用 那 种 类 
型 的 loC 来 指定 bean， 你 可 能 需要 一 个 默认 (LE) 的 构造 方法 。 


Spring loC 容器 可 以 管理 几乎 所 有 你 想 让 它 管 理 的 类 ， 它 不 限于 管理 POJO。 大 多 数 Spring 
用 户 更 喜欢 使 用 POJO (一 个 默认 无 参 的 构造 方法 和 setter,getter 方 法 ) 。 但 在 容器 中 使 用 非 
bean 形式 (non-bean style) 的 类 也 是 可 以 的 。 比 如 遗留 系统 中 的 连接 池 ， 很 显然 它 与 
JavaBean 规 范 不 符 ， 但 Spring 也 能 管理 它 。 


当 使 用 基于 XML 的 元 数据 配置 文件 ， 可 以 这 样 来 指定 bean 类 : 


<bean id="exampleBean" class="examples.ExampleBean"/> 


<bean name="anotherExample" class="examples.ExampleBeanTwo"/> 
给 构造 方法 指定 参数 以 及 为 bean 实 例 化 设置 属性 将 在 后 面 的 依赖 注入 中 详细 说 明 。 


使 用 静态 工厂 方法 实例 化 


当 采 用 静态 工厂 方法 创建 bean 时 ， 除 了 需要 指定 class 属性 外 ， jee aia 
属性 来 指定 创建 bean 实例 的 工厂 方法 。Spring 将 调用 此 方法 (其 可 选 参数 接 下 来 介绍 ) 返 回 实 
例 对 象 ， 就 此 而 言 ， 跟 通过 普通 构造 器 创建 类 实例 没什么 两 样 。 


下 面 的 bean 定义 展示 了 如 何 通过 工厂 方法 来 创建 bean 实 例 。 注 意 ， 此 定义 并 未 指定 返回 对 
象 的 类 型 ， 仅 指定 该 类 包含 的 工厂 方法 。 在 此 例 中 ，createlnstance() 必须 是 一 个 static 方 
法 。 


<bean id="clientService" 
class="examples.ClientService" 
factory-method="createInstance"/> 


public class ClientService { 
private static ClientService clientService = new ClientService(); 
private ClientService() {} 


public static ClientService createInstance() { 


return clientService; 


} 


给 工厂 方法 指定 参数 以 及 为 bean 实 例 设 置 属性 的 详细 内 容 请 查阅 依赖 和 配置 详解 。 
使 用 实例 工厂 方法 实例 化 


与 通过 静态 工厂 方法 实例 化 类 似 ， 通 过 调用 工厂 实例 的 非 静 态 方法 进行 实例 化 。 使 用 这 种 方 
式 时 ，class 属 性 置 为 室 ， 而 factory-bean 属 性 必须 指定 为 当前 (或 其 a 含 工厂 方法 
的 bean 的 名 称 ， 而 该 工厂 bean 的 工厂 方法 本 身 必须 通过 factory-method 属 性 来 设 定 。 


Bean & it 


<!-- IJ bean’ &@createInstance()#7% --> 

<bean id="serviceLocator" class="examples.DefaultServiceLocator"> 
<1-- 其 他 需要 注入 的 依赖 项 --> 

</bean> 


<!-- 通过 工厂 bean 创 建 的 ben --> 

<bean id="clientService" 
factory-bean="serviceLocator" 
factory-method="createClientServiceInstance"/> 


public class DefaultServiceLocator { 


private static ClientService clientService = new ClientServiceImpl(); 
private DefaultServiceLocator() {} 


public ClientService createClientServicelInstance() { 
return clientService; 


一 个 工厂 类 也 可 以 有 多 个 工厂 方法 ， 如 下 代码 所 示 : 


<bean id="serviceLocator" class="examples.DefaultServiceLocator"> 
<!-- 其 他 需要 注入 的 依赖 项 --> 
</bean> 


<bean id="clientService" 
factory-bean="serviceLocator" 
factory-method="createClientServiceInstance"/> 


<bean id="accountService" 
factory-bean="serviceLocator" 
factory-method="createAccountServiceInstance"/> 
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public class DefaultServiceLocator { 


private static ClientService clientService = new ClientServiceImpl(); 
private static AccountService accountService = new AccountServiceImpl(); 


private DefaultServiceLocator() {} 
public ClientService createClientServiceInstance() { 


return clientService; 


public AccountService createAccountServicelInstance() { 
return accountService; 


这 种 做 法 表明 工厂 bean 本 身 也 可 以 通过 依赖 注入 (DI) 进行 管理 配置 。 查 看 依赖 和 配置 详 
解 。 


在 Spring 文 档 中 ，factory bean 是 指 在 Spring 容 器 中 配置 的 工厂 类 通过 实例 或 静态 工厂 方法 
来 创建 对 象 。 相 比 而 言 , FactoryBean (注意 大 小 写 ) 代表 了 Spring 中 特定 的 FactoryBean 


Dependencies 


一 般 情况 下 企业 应 用 不 会 只 有 一 个 对 象 〈 或 者 是 Spring Bean) 。 其 至 最 简单 的 应 用 都 要 多 个 
对 象 来 协同 工作 来 让 终端 用 户 看 到 一 个 完整 的 应 用 的 。 下 一 部 分 将 解释 开发 者 如 何 从 仅仅 定 
义 单 独 的 Bean， 到 让 这 些 Bean 在 一 个 应 用 中 协同 工作 。 


Dependency Injection 


依赖 注入 是 一 个 让 对 象 只 通过 构造 参数 ， 工 厂 方法 的 参数 或 者 配置 的 属性 来 定义 他 们 的 依赖 
的 过 程 。 人 。 容 器 会 在 创建 Bean 的 时 候 注 入 这 些 依 
赖 。 整 个 过 程 完 全 反 转 了 由 Bean 自 己 控 制 实例 化 或 者 引用 依赖 ， 所 以 这 个 过 程 也 称 之 为 控制 
反 转 。 


当 使 用 了 依赖 注入 的 准则 以 后 ， 会 更 易于 管理 和 解 耦 对 象 之 间 的 依赖 ， 使 得 代码 更 加 的 简 
单 。 对 象 不 再 关注 依赖 ， 也 不 需要 知道 依赖 类 的 位 置 。 这 样 的 话 ， 开 发 者 的 类 更 加 易于 测 
试 ， 尤 其 是 当 开 发 者 的 依赖 是 接口 或 者 抽象 类 的 情况 ， 开 发 者 可 以 轻易 在 单元 测试 中 mock 对 
Bo 
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Constructor-based dependency Injection 


基于 构造 函数 的 依赖 注入 是 由 |oC 容 器 来 调用 类 的 构造 函数 ， 构 造 函 数 的 参数 代表 这 个 Bean 所 
依赖 的 对 象 。 跟 调用 带 参数 的 静态 工厂 方法 基本 一 样 。 下 面 的 例子 展示 了 一 个 类 通过 构造 函 
数 来 实现 依赖 注入 的 。 需 要 注意 的 是 ， 这 个 类 没有 任何 特殊 的 地 方 ， 只 是 一 个 简单 的 ， 不 依 
赖 于 任何 容器 特殊 接口 ， 基 类 或 者 注解 的 普通 类 


public class SimpleMovieLister { 


// the SimpleMovieLister has a dependency on a MovieFinder 
private MovieFinder movieFinder; 


// a constructor so that the Spring container can inject a MovieFinder 
public SimpleMovieLister(MovieFinder movieFinder) { 
this.movieFinder = movieFinder; 


} 


// business logic that actually uses the injected MovieFinder is omitted... 


构造 函数 的 参数 解析 
构造 函数 的 参数 解析 是 通过 参数 的 类 型 来 匹配 的 。 如 果 在 Bean 的 构造 函数 参数 不 存在 歧义 ， 


那么 构造 器 参数 的 顺序 也 就 是 就 是 这 些 参数 实例 化 以 及 装载 的 顺序 。 参 考 如 下 代码 : 


package x.y; 
public class Foo { 


public Foo(Bar bar, Baz baz) { 
Wn wo 


} 


假设 Bar 和 Baz 在 继承 层次 上 不 相关 ， 也 没有 什么 歧义 的 话 ， 下 面 的 配置 完全 可 以 工作 正 
常 开发 者 不 需要 再 去 <constructor-arg> 元 素 中 指定 构造 函数 参数 的 索引 或 类 型 信息 © 


<beans> 
<bean id="foo" class="x.y.Foo"> 
<constructor-arg ref="bar"/> 
<constructor-arg ref="baz"/> 
</bean> 


<bean id="bar" class="x.y.Bar"/> 


<bean id="baz" class="x.y.Baz"/> 
</beans> 


当 引 用 另 一 个 Bean 的 时 候 ， 如 果 类 型 确定 的 话 ， 匹 配 会 工作 正常 《如 上 面 的 例子 ) . 当 使 用 简 
单 的 类 型 的 时 候 ， 比 如 说 <value>true</value> ， Spring 人 无 法 判断 值 的 类 型 的 ， 所 
以 是 无 法 匹配 的 。 考 虑 代码 如 下 : 


package examples; 
public class ExampleBean { 


// Number of years to calculate the Ultimate Answer 
private int years; 


// The Answer to Life, the Universe, and Everything 
private String ultimateAnswer; 


public ExampleBean(int years, String ultimateAnswer) { 
this.years = years; 
this.ultimateAnswer = ultimateAnswer; 


在 上 面 代 码 这 种 情况 下 ， 容 器 可 以 通过 使 用 构造 函数 参数 的 type 属性 来 实现 简单 类 型 的 匹 
配 。 比 如 : 


<bean id="exampleBean" class="examples.ExampleBean"> 
<constructor-arg type="int" value="7500000"/> 
<constructor-arg type="java.lang.String" value="42"/> 
</bean> 


或 者 使 用 index 属性 来 指定 构造 参数 的 位 置 ， 比 如 : 


<bean id="exampleBean" class="examples.ExampleBean"> 
<constructor-arg index="0" value="7500000"/> 
<constructor-arg index="1" value="42"/> 

</bean> 


这 个 索引 也 同时 是 为 了 解决 构造 函数 中 有 多 人 
意 的 是 ， 索 引 是 基于 0 开始 的 。 开 发 者 也 可 以 通过 参数 的 名 称 来 去 除 二 义 性 。 


<bean id="exampleBean" class="examples.ExampleBean"> 
<constructor-arg name="years" value="7500000"/> 
<constructor-arg name="ultimateAnswer" value="42"/> 
</bean> 


需要 注意 的 是 ,做 这 项 工作 的 代码 必须 启用 了 调试 标记 编译 ,这 样 Spring 才 可 以 从 构造 函数 查找 
参数 名 称 。 开发 者 也 可 以 使 用 @ConstructorProperties 注解 来 显 式 声明 构造 学 HG AR > rote 
如 下 代码 : 


package examples; 
public class ExampleBean { 
// Fields omitted 


@ConstructorProperties({"years", "ultimateAnswer"}) 
public ExampleBean(int years, String ultimateAnswer) { 
this.years = years; 
this.ultimateAnswer = ultimateAnswer; 


Setter-based dependency injection 


基于 Setter 函 数 的 依赖 注入 则 是 容器 会 调用 Bean 的 无 参 构 造 函 数 ， 或 者 无 参数 的 工厂 方法 ， 
然后 再 来 调用 Setter 方 法 来 实现 的 依赖 注入 。 


下 面 的 例子 展示 了 使 用 Setter 方 法 进行 的 依赖 注入 ， 下 面 的 类 对 象 只 是 简单 的 POJO 对 象 ， 不 
依赖 于 任何 Spring 的 特殊 的 接口 ， 基 类 或 者 注解 。 


public class SimpleMovieLister { 


// the SimpleMovieLister has a dependency on the MovieFinder 
private MovieFinder movieFinder; 


// a setter method so that the Spring container can inject a MovieFinder 
public void setMovieFinder(MovieFinder movieFinder) { 
this.movieFinder = movieFinder; 


// business logic that actually uses the injected MovieFinder is omitted... 


Applicationcontext 所 管理 Bean 对 于 基于 构造 函数 的 依赖 注入 ， 或 者 基于 Setter 方 式 的 依赖 
注入 都 是 支持 的 。 同 时 也 支持 使 用 Setter 方 式 在 通过 构造 函数 注入 依赖 之 后 再 次 注入 依赖 。 开 
发 者 在 BeanDefinition 中 可 以 使 用 propertyEditor 实例 来 自由 选择 注入 的 方式 。 然 而 ， 大 多 
数 的 开发 者 并 不 直接 使 用 这 些 类 ， 而 是 跟 喜 欢 XML 形 式 的 bean 定义 ， 或 者 基于 注解 的 组 件 
(比如 使 用 @Component ? @Controller F) 或 者 在 配置 了 @Configuration 的 类 上 面 使 

用 @Bean 的 方法 。 


基于 构造 函数 还 是 基于 Setter 方 法 ? 因为 开发 者 可 以 混用 两 者 ， 所 以 通常 比较 好 的 方式 
是 通过 构造 函数 注入 必要 的 依赖 通过 Setter 方 式 来 注入 一 些 可 选 的 依赖 。 其 中 ， 在 Setter 
方法 上 面 的 @Required 注解 可 用 来 构造 必要 的 依赖 。 Spring 队 伍 推荐 基于 构造 函数 的 注 
入 ， 因 为 这 种 方式 会 促使 开发 者 将 组 件 开发 成 不 可 变 对 象 而 且 确 保 了 注入 的 依赖 不 

为 null 。 而 有 全， 基于 构造 函数 的 注入 的 组 件 被 客户 端 调用 的 时 候 也 是 完全 构造 好 的 。 当 
然 ， 从 另 一 方面 来 说 ， 过 多 的 构造 函数 参数 也 是 非常 差 的 代码 方式 ， 这 种 方式 说 明 类 和 貌 
似 有 了 太 多 的 功能 ， 最 好 重 构 将 不 同 职能 分 离 。 基于 Setter 的 注入 只 是 用 于 可 选 的 依 

赖 ， 但 是 也 最 好 配置 一 些 合理 的 默认 值 。 否 则 ， 需 要 对 代码 的 依赖 进行 非 NULL 的 检查 
了 。 基 于 Setter 方 法 的 注入 有 一 个 便利 之 处 在 于 这 种 方式 的 注入 是 可 以 进行 重 配 置 和 重新 
注入 的 。 依赖 注入 的 两 种 风格 适合 大 多 数 的 情况 ， 但 是 有 时 使 用 第 三 方 的 库 的 时 候 ， 开 
发 者 可 能 并 没有 源码 ， 而 第 三 方 的 代码 也 没有 setter 方 法 ， 那 么 就 只 能 使 用 基于 构造 邑 数 
的 依赖 注入 了 。 


Dependency resolution process 
容器 对 Bean 的 解析 如 下 : 


o 创建 并 根据 描述 的 元 数据 来 实例 化 Applicationcontext 。 配 置 元 数据 可 以 通过 XML > 
Java 代码 ， 或 者 注解 。 

。 每 一 个 Bean 的 依赖 通过 构造 函数 参数 或 者 属性 或 者 静态 工厂 方法 的 参数 等 来 表示 。 这 些 
依赖 会 在 Bean 创 建 的 的 时 候 注入 和 装载 。 

© 每 一 个 属性 或 者 构造 函数 的 参数 都 是 实际 定义 的 值 或 者 引用 容器 中 其 他 的 Bean。 

© 每 一 个 属性 或 者 构造 参数 可 以 根据 其 指定 的 类 型 转换 而 成 。Spring 也 可 以 将 String 转 成 默 
认 的 Java 内 在 的 类 型 ， 比 如 int , long , String , boolean 等 。 
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Spring 容器 会 在 容器 创建 的 时 候 针 对 每 一 个 Bean 进 行 校 验 。 然 而 ，Bean 的 属性 在 Bean 没 用 
正 创建 的 时 候 是 不 会 配置 进去 的 。 单 例 类 型 的 Bean 是 容器 创建 的 时 候 配置 成 预 实例 状态 的 。 
Bean 的 scope 在 后 续 有 介绍 。 其 他 的 Bean 都 只 有 在 请 求 的 时 候 ， 才 会 创建 。 显 然 创建 Bean 
对 象 会 有 一 个 依赖 的 图 。 这 个 图 表示 Bean 之 间 的 依赖 关系 ， 容 器 根据 此 来 决定 创建 和 配置 
Bean 的 顺序 。 


循环 依赖 如 果 开 发 者 主要 使 用 基于 构造 函数 的 依赖 注入 ， 那 么 很 有 可 能 出 现 一 个 循环 依 
赖 的 场景 。 比 如 说 : 类 A 在 构造 函数 中 依赖 于 类 B 的 实例 ， 而 类 B 的 构造 函数 依赖 类 A 的 
实例 。 如 果 你 这 么 配置 类 A 和 类 B 相 互 注入 的 话 ，Spring loC 容 器 会 发 现 这 个 运行 时 的 循 
环 依 赖 ， 并 且 抛 出 BeancurrentlyIncreationException 。 开发 者 可 以 通过 使 用 Setter 方 法 
来 配置 依赖 注入 ， 这 样 可 以 解决 这 个 问题 。 或 者 就 不 使 用 基于 构造 函数 的 依赖 注入 ， 仅 
仅 使 用 基于 Setter 方 法 的 依赖 注入 。 换 言 之 ， 尽 管 不 推荐 ， 但 是 开发 者 可 以 将 循环 依赖 配 
置 为 基于 Setter 方 法 的 依赖 注入 。 


开发 者 可 以 相信 Spring 能 正确 处 理 Bean。Spring 能 够 在 加 载 的 过 程 中 发 现 配 置 的 问题 ， 比 如 
引用 到 不 存在 的 Bean 或 者 是 循环 依赖 。Spring 会 尽 可 能 晚 的 在 Bean 创 建 的 时 候 装 载 属性 或 者 
解析 依赖 。 这 也 意味 着 Spring 容器 加 载 正 确 后 会 在 Bean 注 入 依赖 出 错 的 时 候 抛 出 异常 。 比 


如 ，Bean 抛 出 缺 少 属性 或 者 属性 不 合法 2 这 延迟 的 解析 也 是 为 什么 ApplicationContext 的 实 
现 会 令 单 例 Bean 处 于 预 实例 化 状态 。 这 样 ， 通 过 ApplicationContext 的 创建 ， 可 以 在 申 正 使 
用 Bean 之 前 消耗 一 些 内 存 代价 发 现 配置 的 问题 。 开 发 者 也 可 以 覆盖 默认 的 行为 让 单 例 Bean 延 
迟 加 载 ， 而 不 是 处 于 预 实例 化 状态 。 如果 不 存在 循环 依赖 的 话 ，Bean 所 引用 的 依赖 会 优先 完 
全 构造 依赖 的 。 举 例 来 说 ， 如 果 Bean Atk T Bean B > 48 A Spring loC 容 器 会 先 配 置 Bean 
B， 然 后 调用 Bean A 的 Setter 方 法 来 构造 Bean A。 换 言 之 ，Bean 先 会 实例 化 ， 然 后 注入 依 
赖 ， 然 后 才 是 相关 的 生命 周期 方法 的 调用 。 


Examples of dependency injection 


下 面 的 例子 会 使 用 基于 XML 配置 的 元 数据 ， 然 后 使 用 Setter 方 式 进行 依赖 注入 。 代 码 如 下 : 


<bean id="exampleBean" class="examples.ExampleBean"> 
<!-- setter injection using the nested ref element --> 
<property name="beanOne"> 
<ref bean="anotherExampleBean"/> 
</property> 


<!-- setter injection using the neater ref attribute --> 
<property name="beanTwo" ref="yetAnotherBean"/> 
<property name="integerProperty" value="1"/> 

</bean> 


<bean id="anotherExampleBean" class="examples.AnotherBean"/> 
<bean id="yetAnotherBean" class="examples.YetAnotherBean"/> 


public class ExampleBean { 


private AnotherBean beanOne; 
private YetAnotherBean beanTwo; 
private int i; 


public void setBeanOne(AnotherBean beanOne) { 


this.beanOne = beanOne; 


public void setBeanTwo(YetAnotherBean beanTwo) { 
this.beanTwo = beanTwo; 


public void setIntegerProperty(int i) { 
Gnesi = 


在 上 面 的 例子 当中 ，Setter 方 法 的 声明 和 XML 文件 中 相 一 致 ， 下 面 的 例子 是 基于 构造 函数 的 依 
PIŁA 


<bean id="exampleBean" class="examples.ExampleBean"> 
<!-- constructor injection using the nested ref element --> 
<constructor-arg> 
<ref bean="anotherExampleBean"/> 
</constructor-arg> 


<!-- constructor injection using the neater ref attribute --> 
<constructor-arg ref="yetAnotherBean"/> 


<constructor-arg type="int" value="1"/> 
</bean> 


<bean id="anotherExampleBean" class="examples.AnotherBean"/> 
<bean id="yetAnotherBean" class="examples.YetAnotherBean"/> 


public class ExampleBean { 


private AnotherBean beanOne; 
private YetAnotherBean beanTwo; 
private int i; 


public ExampleBean( 
AnotherBean anotherBean, YetAnotherBean yetAnotherBean, int i) { 
this.beanOne = anotherBean; 
this.beanTwo = yetAnotherBean; 
this.i = i; 


在 Bean 定 义 之 中 的 构造 函数 参数 就 是 用 来 构造 ExampleBean 的 依赖 。 


下 面 的 例子 ， 是 通过 静态 的 工厂 方法 来 返回 Bean 实 例 的 。 


<bean id="exampleBean" class="examples.ExampleBean" factory-method="createInstance"> 
<constructor-arg ref="anotherExampleBean"/> 
<constructor-arg ref="yetAnotherBean"/> 
<constructor-arg value="1"/> 

</bean> 


<bean id="anotherExampleBean" class="examples.AnotherBean"/> 
<bean id="yetAnotherBean" class="examples.YetAnotherBean"/> 


public class ExampleBean { 


// a private constructor 
private ExampleBean(...) { 


// a static factory method; the arguments to this method can be 
// considered the dependencies of the bean that is returned, 
// regardless of how those arguments are actually used. 
public static ExampleBean createInstance ( 
AnotherBean anotherBean, YetAnotherBean yetAnotherBean, int i) { 


ExampleBean eb = new ExampleBean (...); 
// some other operations... 
return eb; 


工厂 方法 的 参数 ， 也 是 通过 <constructor-arg/> 标签 来 指 定 的 ， 和 基于 构造 函数 的 依赖 注入 
是 一 致 的 。 之 前 有 提 到 过 ， 返 回 的 类 型 不 需要 跟 exampleBean 中 的 class 属性 一 臻 

的 ， class 指定 的 是 包含 工厂 方法 的 类 。 当 然 了 ， 上 面 的 例子 是 一 致 的 。 使 用 factory- 
bean 的 实例 工厂 方法 构造 Bean 的 ， 这 里 就 不 多 描述 了 。 


7.4.2 Dependencies and configuration in detail 


如 前 文 所 述 ， 开 发 者 可 以 通过 定义 Bean 的 依赖 的 来 引用 其 他 的 Bean 或 者 是 一 些 值 的 ，Spring 
基于 XML 的 配置 元 数据 通过 支持 一 些 子 元 素 <property/> 以 及 <constructor-arg/> 来 达到 这 一 
目的 。 


Straight values (primitives, Strings, and so on) 


元 素 <property/> A value 属性 来 对 人 友好 多 读 的 形 式 配置 一 个 属性 或 者 构造 参数 © Spring 的 
便利 之 处 就 是 用 来 将 这 些 字符 串 的 值 转换 成 指定 的 类 型 。 


<bean id="myDataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method 
="close"> 

<!-- results in a setDriverClassName(String) call --> 

<property name="driverClassName" value="com.mysql.jdbc.Driver"/> 

<property name="url" value="jdbc:mysql://localhost :3306/mydb"/> 

<property name="username" value="root"/> 

<property name="password" value="masterkaoli"/> 
</bean> 


下 面 的 例子 使 用 的 p 命 名 空间 ， 是 更 为 简单 的 XML 配置 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:p="http://www.springframework.org/schema/p" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="myDataSource" class="org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close" 
p:driverClassName="com.mysql.jdbc.Driver" 
p:url="jdbc:mysql://localhost :3306/mydb" 
p:username="root" 
p:password="masterkaoli"/> 


</beans> 


上 面 的 XML 更 为 的 简洁 ， 但 是 因为 属性 的 类 型 是 在 运行 时 确定 的 ， 而 非 设 计时 确定 的 ， 所 以 
除非 使 用 IntelliJ IDEA 或 者 Spring Tool Suite 这 些 工具 才能 在 定义 Bean 的 时 候 自动 完成 属性 配 
置 。 当 然 很 推荐 使 用 这 些 IDE © 


开发 者 也 可 以 定义 一 个 java.util.Properties 实例 ， 比 如 : 


<bean id="mappings" 


class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 


<!-- typed as a java.util.Properties --> 
<property name="properties"> 
<value> 
jdbc.driver.className=com.mysql.jdbc.Driver 
jdbc.url=jdbc:mysql://localhost :3306/mydb 
</value> 
</property> 
</bean> 


Spring 的 容器 会 将 <value/> 里 面 的 文本 通过 使 用 JavaBean 的 PropertyEditor 机 制 转换 成 一 
个 java.util.Properties 实例 。 这 也 是 一 个 捷径 ， 也 是 一 些 Spring 团 KEEKEKE 
的 <value/> 元 素 而 不 是 value 属性 风格 。 


idref 元 素 idref 元 素 是 一 种 简单 的 提前 校 验 错误 的 方式 ， 通 过 jd 来 关联 容器 中 的 其 他 的 Bean 
的 方式 。 


<bean id="theTargetBean" class="..."/> 


<bean id="theClientBean" class="..."> 
<property name="targetName"> 
<idref bean="theTargetBean" /> 
</property> 
</bean> 


上 述 的 Bean 的 定义 在 运行 时 ， 和 如 下 定义 是 完全 一 致 的 。 


<bean id="theTargetBean" class="..." /> 


<bean id="client" class="..."> 
<property name="targetName" value="theTargetBean" /> 
</bean> 


第 一 种 方式 是 更 值得 提倡 的 ， 因 为 使 用 了 idref 标签 ， 会 是 的 容器 在 部 署 阶段 就 针对 Bean 进 

行 校 验 ， 确 保 Bean 一 定 存 在 。 而 第 二 个 版 本 的 话 ， 是 没有 任何 校 验 的 。 只 有 实际 上 引用 了 

Bean client ， 在 实例 化 client 的 时 候 才 会 发 现 。 如 果 client 是 一 个 prototype 4JBean°? 7#% 
么 类 似 拼 写 之 类 的 错误 会 在 容器 部 署 以 后 很 久 才 能 发 现 。 


idref 元 素 的 local 属性 在 4.0 以 后 的 xsd 中 已 经 不 再 支持 了 ， 而 是 使 用 了 bean 引用 。 
如 果 更 新 了 版 本 的 话 ， 需 要 将 idref local 引用 都 转换 成 idref bean PPT ° 


References to other beans (collaborators) 


ref 元 素 在 <constructor-arg/> 或 者 <property/> 中 的 一 个 终极 标签 。 开 发 者 可 以 通过 这 个 
标签 配置 一 个 Bean 来 引用 另 一 个 Bean。 当 需要 引用 一 个 Bean 的 时 候 ， 被 引用 的 Bean 会 先 实 
例 化 ， 然 后 配置 属性 ， 也 就 是 引用 的 依赖 。 如 果 该 Bean 是 单 例 Bean 的 话 ， 那 么 该 Bean 会 早 
由 容器 初始 化 。 最 终 的 引用 另 一 个 对 象 的 所 有 引用 。Bean 的 范围 以 及 校 验 取决 于 开发 者 是 否 
通过 bean , local , parent 这 些 属性 来 指 定 对 象 的 id 或 者 name 属 性 。 


通过 指定 Bean 的 bean 属性 中 的 <ref/> 来 指定 依赖 是 最 常见 的 一 种 方式 ， 可 以 引用 容器 或 者 
父 容器 中 的 Bean， 无 论 是 否 在 同一 个 XML 文件 定义 都 可 以 引用 。 其 中 bean 属性 中 的 值 可 以 
和 其 六 他 引用 Bean 中 的 id 属性 一 致 或 者 和 其 中 的 一 个 name 属性 一 致 的 2 


<ref bean="someBean"/> 


通过 指定 Bean 的 parent 属性 会 创 建 一 个 引用 到 当前 容器 的 父 容器 之 中 ° parent 属性 的 值 可 
以 跟 跟 目标 Bean 的 id 属性 一 致 ， 或 者 和 目标 Bean 的 name 属性 中 的 一 个 一 致 ， 目标 Bean 必 
须 是 当前 引用 目标 Bean 容 器 的 父 容器 。 开 发 者 一 般 只 有 在 存在 层次 化 容器 ， 并 且 和 希望 通过 代 
理 来 包 右 父 容器 中 一 个 存在 的 Bean 的 时 候 才 会 用 到 这 个 属性 。 


<!-- in the parent context --> 

<bean id="accountService" class="com.foo.SimpleAccountService"> 
<!-- insert dependencies as required as here --> 

</bean> 


<!-- in the child (descendant) context --> 

<bean id="accountService" <!-- bean name is the same as the parent bean --> 
class="org.springframework.aop.framework.ProxyFactoryBean"> 
<property name="target"> 


<ref parent="accountService"/> <!-- notice how we refer to the parent bean --> 
</property> 
<!-- insert other configuration and dependencies as required here --> 


</bean> 


与 idref 标签 一 样 ， ref 元 素 中 的 local 标签 在 xsd 4.0 以 后 已 经 不 再 支持 了 ， 开 发 者 可 
以 通过 将 已 存在 的 ref local A ref bean 来 完成 更 新 Spring 9 


Inner beans 


定义 在 <bean/> 元 素 的 <property/> 或 者 <constructor-arg/> 元 素 之 内 的 Bean 叫 做 内 部 Bean 


<bean id="outer" class="..."> 
<!-- instead of using a reference to a target bean, simply define the target bean 
inline --> 
<property name="target"> 
<bean class="com.example.Person"> <!-- this is the inner bean --> 
<property name="name" value="Fiona Apple"/> 
<property name="age" value="25"/> 
</bean> 
</property> 
</bean> 


内 部 Bean 的 定义 是 不 需要 指定 id 或 者 名 字 的 。 如 果 指 定 了 ， 容 器 也 不 会 用 之 作为 分 别 Bean 的 
区 分 标识 。 容 器 同时 也 会 无 视 内 部 Bean 的 scope 标签 : 内 部 Bean 总 是 匿名 的 ， 而 且 总 是 随 
着 外 部 的 Bean 同 时 创建 的 。 开 发 者 是 无 法 将 内 部 的 Bean 注 入 到 外 部 Bean 以 外 的 其 他 Bean 

的 。 


当然 ， 也 有 可 能 从 指定 范围 接收 到 破坏 性 回调 。 比 如 : 一 个 请 求 范围 的 内 部 Bean 包 含 了 一 个 
单 例 的 Bean， 那 么 At Bean: H aor Ae 包含 的 Bean， 而 包含 的 Bean 允 许 访问 
到 request 的 scope 生命 周期 。 这 种 场 景 不 常 FIL? 内 部 Bean 通 常 只 是 共享 它 的 外 部 Bean ° 


Collections 


在 <list/> , <set/> , <map/> 和 <props/> 元 素 中 ， 开 发 者 可 以 配置 Java 集 合 类 
型 List , Set, Map 以 及 Properties 的 属性 和 参数 。 


<bean id="moreComplexObject" class="example.ComplexObject"> 
<!-- results in a setAdminEmails(java.util.Properties) call --> 
<property name="adminEmails"> 
<props> 
<prop key="administrator">administrator@example.org</prop> 
<prop key="Support">support@example.org</prop> 
<prop key="development">development@example.org</prop> 


</props> 
</property> 
<!-- results in a setSomeList(java.util.List) call --> 


<property name="someList"> 
<list> 
<value>a list element followed by a reference</value> 
<ref bean="myDataSource" /> 


</list> 
</property> 
<!-- results in a setSomeMap(java.util.Map) call --> 


<property name="someMap"> 
<map> 
<entry key="an entry" value="just some string"/> 
<entry key ="a ref" value-ref="myDataSource"/> 


</map> 
</property> 
<!-- results in a setSomeSet(java.util.Set) call --> 


<property name="someSet"> 
<set> 
<value>just some string</value> 
<ref bean="myDataSource" /> 
</set> 
</property> 
</bean> 


当然 ，map 的 key 或 者 value， 或 者 是 集合 的 value 都 可 以 配置 为 下 列 之 中 的 一 些 元 素 : 


bean | ref | idref | list | set | map | props | value | null 


集合 合并 Spring 的 容器 也 支持 来 合并 集合 。 开 发 者 可 以 定义 一 个 父 样式 

的 <list/> , <map/> , <set/> 或 者 <props/> ， 同 时 有 子 样式 的 <list/> ，<map/> , <set/> 或 
者 <props/> 继承 并 且 黎 益 父 集合 。 也 就 是 说 ， 子 集合 的 值 是 父 元 素 和 子 元 素 集合 的 合并 值 。 
比如 下 面 的 例子 。 


<beans> 
<bean id="parent" abstract="true" class="example.ComplexObject"> 


<property name="adminEmails"> 


<props> 
<prop key="administrator">administrator@example.com</prop> 
<prop key="Support">support@example.com</prop> 
</props> 
</property> 
</bean> 
<bean id="child" parent="parent"> 


<property name="adminEmails"> 
<!-- the merge is specified on the child collection definition --> 


<props merge="true"> 
<prop key="sales">sales@example.com</prop> 
<prop key="Support">support@example.co.uk</prop> 
</props> 
</property> 
</bean> 
<beans> 


可 以 发 现 ， 我 们 在 child Bean 上 使 用 了 merge=true 属性 。 当 child Bean 由 容器 初始 化 且 实 
例 化 的 时 候 ， 其 实例 中 包含 的 adminEmails 集合 就 是 child 的 adminEmails 以 
及 parent 的 adminEmails 集合 。 如 下 : 


administrator=administrator@example.com 
sales=sales@example.com 
support=support@example.co.uk 


child 的 Properties 集合 的 值 继承 了 parent 的 <props/> ° child 的 值 也 支持 重 

写 parent 的 值 

这 个 合并 的 行为 和 <list/> ，<map/> 以 及 <set/> 之 类 的 集合 类 型 的 行为 是 类 似 

ÁJ o <list/> 的 特定 的 例子 中 ;与 List 集合 类 型 类 似 2 有 隐 含 的 ordered 概念 的 。 所 有 的 父 
元 素 里 面 的 值 ， 是 在 所 有 和 孩子 元 素 的 值 之 前 的 。 但 是 像 map , set 或 者 properties 的 集合 类 
型 ， 是 不 存在 顺序 的 。 

集合 合并 的 限制 

开发 者 是 不 能 够 合并 不 同类 型 的 集合 的 (比如 map 和 List 合并 ) ， 如 果 开 发 者 这 么 做 ， 会 
抛 出 异常 ° merge 的 属性 是 必须 特 指 到 更 低级 或 者 继承 者 ， 子 节点 的 定义 上 。 特 指 merge By 
性 到 父 集合 的 定义 上 是 宛 余 的 ， 而 且 在 合并 上 也 没有 任何 效果 。 

强 类 型 集合 在 Java 5 以 后 ， 开 发 者 可 以 使 用 强 类 型 的 集合 了 。 也 就 是 ， 开 发 者 可 以 声明 一 
个 collection 类 型 ， 然 后 这 个 集合 只 和 包含 string 元 素 (举例 来 说 ) 。 如 果 开 发 者 通过 Spring 
来 注入 强 类 型 的 collection 到 Bean 中 ， 开 发 者 就 可 以 利用 Spring 的 类 型 转换 支持 来 做 到 。 


public class Foo { 
private Map<String, Float> accounts; 


public void setAccounts(Map<String, Float> accounts) { 
this.accounts = accounts; 


} 
} 
<beans> 
<bean id="foo" class="x.y.Foo"> 
<property name="accounts"> 
<map> 
<entry key="one" value="9.99"/> 
<entry key="two" value="2.75"/> 
<entry key="six" value="3.99"/> 
</map> 
</property> 
</bean> 
</beans> 


4 foo 的 属性 accounts 准备 注入 的 时 候 ， accounts 的 泛 型 信息 map<String, Float> 就 会 通 
过 反射 拿 到 。 这 样 ，Spring 的 类 型 转换 系统 能 够 识别 不 同 的 类 型 ， 如 上 面 的 例子 Float 然后 
将 字符 串 的 值 9.99, 2.75 以 及 3.99 转换 成 对 应 的 Float 类 型 。 


Null and empty string values 


Spring 将 会 将 属性 的 空 参数 ， 直 接 当成 空 字符 串 来 处 理 。 下 面 的 基于 XML 的 元 数据 配置 就 会 
将 email 属 性 配置 为 String 的 值 为 we 


<bean class="ExampleBean"> 
<property name="email" value=""/> 
</bean> 


上 面 的 例子 和 下 列 JAVA 代码 是 一 致 的 。 


exampleBean.setEmail("") 


而 <null/> 元 素来 处 理 null 的 值 。 如 下 : 


<bean class="ExampleBean"> 
<property name="email"> 
<null/> 
</property> 
</bean> 


上 面 的 代码 和 下 面 的 Java 代 码 是 一 样 的 效果 : 


exampleBean.setEmail(null) 


XML shortcut with the p-namespace 


p 命 名 空间 令 开 发 者 可 以 使 用 bean HB > KA ARB <property/> 元 素 ， 就 能 描述 
开发 者 想 要 注入 的 依赖 。 


Spring 是 支持 基于 XML 的 格式 化 的 命名 空间 扩展 的 。 本 节 讨 论 的 beans 的 配置 都 是 基于 XML 
的 ，p 命 名 空间 并 不 是 定义 在 XSD 文件 ， 而 是 定义 在 Spring Core 之 中 的 。 


下 面 展示 了 两 种 XML 片段 是 同样 的 解析 结果 : 第 一 个 使 用 的 标准 的 XML 格式 ， 而 第 二 种 使 用 
了 p 命 名 空间 。 


<beans xmlns="http://www. springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:p="http://www.springframework.org/schema/p" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 


<bean name="classic" class="com.example.ExampleBean"> 
<property name="email" value="foo@bar.com"/> 
</bean> 


<bean name="p-namespace" class="com.example.ExampleBean" 


p:email="foo@bar .com"/> 
</beans> 


上 面 的 例子 在 Bean 中 展示 了 email 属 性 的 定义 。 这 种 定义 告知 Spring 这 是 一 个 属性 的 声明 。 如 
前 面 所 描述 ，p 命 名 空间 并 没有 标准 模式 定义 ， 所 以 你 可 以 配置 属性 的 名 字 为 依赖 名 字 。 


下 面 的 例子 包括 了 2 个 Bean 定 义 ， 引 用 了 另外 的 Bean : 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmins:p="http://www.springframework.org/schema/p" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 


<bean name="john-classic" class="com.example.Person"> 
<property name="name" value="John Doe"/> 
<property name="Spouse" ref="jane"/> 

</bean> 


<bean name="john-modern" 
class="com.example.Person" 
p:name="John Doe" 
p:spouse-ref="jane"/> 


<bean name="jane" class="com.example.Person"> 
<property name="name" value="Jane Doe"/> 
</bean> 
</beans> 


从 上 述 的 例子 中 可 以 看 出 ， john-modern 不 止 包含 一 个 属性 ， 也 同时 使 用 了 特殊 的 格式 来 声明 
一 个 引用 指向 另 一 个 Bean。 第 一 个 Bean 定 义 使 用 的 是 <property name="spouse" 

ref="jane"/> 来 创建 的 Bean 引 用 到 另外 一 个 Bean， 而 第 二 个 Bean 的 定义 使 用 了 p:Spouse- 
ref="jane" 来 作为 一 个 指向 Bean 的 引用 。 在 这 个 例子 中 Spouse 是 属性 的 名 字 ， 而 -ref 部 分 
表 名 这 个 依赖 不 是 直接 的 类 型 ， 而 是 引用 另 一 个 Bean。 


p 命 名 空间 并 不 同 标 准 的 XML 格式 一 样 灵活 。 比 如 ， 声 明 属 性 的 引用 可 能 和 一 些 
以 Ref 结尾 的 属性 相 冲 突 ， 而 标准 的 XML 格式 就 不 会 。Spring 团 队 推荐 开发 者 能 够 和 团 
队 商 量 一 下 ， 要 使 用 哪 一 种 方式 ， 而 不 要 同时 使 用 3 种 方法 。 


XML shortcut with the c-namespace 


与 p 命 名 空间 类 似 ，C 命 名 空间 是 在 Spring 3.1 首 次 引入 的 ，c 命 名 空间 允许 内 联 的 属性 来 配置 
构造 参数 而 不 用 使 用 constructor-arg 元 素 。 下 面 就 是 一 个 使 用 了 c 命 名 空间 的 例子 : 


<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmins:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="bar" class="x.y.Bar"/> 
<bean id="baz" class="x.y.Baz"/> 


<!-- traditional declaration --> 

<bean id="foo" class="x.y.Foo"> 
<constructor-arg ref="bar"/> 
<constructor-arg ref="baz"/> 
<constructor-arg value="foo@bar .com"/> 

</bean> 


<!-- c-namespace declaration --> 
<bean id="foo" class="x.y.Foo" c:bar-ref="bar" c:baz-ref="baz" c:email="foo@bar .co 


m"/> 


</beans> 


命名 空间 使 用 了 和 p: 命名 空间 相 类 似 的 方式 (使 用 了 -ref 来 配置 引用 ) 。 而 且 ， 同 样 
的 ，C 命 名 空间 也 不 是 定义 在 XSD 的 模式 之 中 (但 是 在 Spring Core 之 中 ) 。 


在 少数 的 例子 之 中 ， 构 造 函 数 的 参数 名 字 并 不 可 用 (通常 ， 如 果 字 节 码 没有 debug 信 息 的 编 
译 ) ， 开 发 者 可 以 使 用 下 面 的 例子 


<!-- c-namespace index declaration --> 
<bean id="foo" class="x.y.Foo" c:_0-ref="bar" c:_1-ref="baz"/> 


根据 XML 语法 ， 索 引 的 概念 的 存在 要 求 使 用 “作为 XML 属性 名 字 不 能 以 数字 开始 。 
实际 上 ， 构 造 函 数 的 解析 机 制 在 匹配 参数 是 很 高 效 的 ， 除 非 必 要 ，Spring 团 队 推 荐 在 配置 中 使 
用 命名 空间 。 


Compound property names 


开发 者 可 以 在 配置 属性 的 时 候 配 置 混 合 的 属性 ， 只 要 所 有 的 组 件 路 径 (除了 最 后 一 个 属性 名 
字 ) 不 能 为 null 。 参考 如 下 的 定义 。 


<bean id="foo" class="foo.Bar"> 
<property name="fred.bob.sammy" value="123" /> 
</bean> 


foo 有 一 个 fred 的 属性 ， 而 其 中 fred 属性 有 一 个 bob 属性 ， 而 bob 属性 之 中 有 一 
个 sammy 属性 ， 那 么 最 后 这 个 sammy 属性 会 配置 为 123 。 想 要 上 述 的 配置 能 够 生 
效 ， fred 属性 需要 有 一 个 bob 属性 且 在 fred 构造 只 是 构造 之 后 不 为 null > SMASH 


出 NullPointerException ° 


7.4.3 Using depends-on 


如 果 一 个 Bean 是 另 一 个 Bean 的 依赖 的 话 ， 通 常 来 说 这 个 Bean 也 就 是 另 一 个 Bean 的 属性 之 
一 。 多 数 情况 下 ， 开 发 者 可 以 在 配置 XML 元 数据 的 时 候 使 用 <ref/> 标签 。 然 而 ， 有 时 Bean 

之 间 的 依赖 关系 不 是 直接 关联 的 。 比 如 : 需要 调用 类 的 静态 实例 化 器 来 触发 ， 类 似 数据 库 驱 
动 注册 。 depends-on 属性 会 使 明确 的 强迫 依赖 的 Bean 在 引用 之 前 就 会 初始 化 。 下 面 的 例子 使 
用 depends-on 属性 来 让 表示 单 例 Bean 上 的 依赖 的 。 


<bean id="beanOne" class="ExampleBean" depends-on="manager"/> 
<bean id="manager" class="ManagerBean" /> 


如 果 想 要 依赖 多 个 Bean， 可 以 提供 多 个 名 字 作为 depends-on 的 值 ， 以 过 号 ， 空 格 ， 或 者 分 号 
TA TF: 


<bean id="beanOne" class="ExampleBean" depends-on="manager, accountDao"> 
<property name="manager" ref="manager" /> 
</bean> 


<bean id="manager" class="ManagerBean" /> 
<bean id="accountDao" class="x.y.jdbc.JdbcAccountDao" /> 


Bean ¥ 4) depends-on 属性 可 以 同时 指定 一 个 初始 化 时 间 的 依赖 以 及 一 个 相应 的 销毁 时 依 
赖 〈 单 例 Bean 情 况 ) 。 独 立 的 定义 了 depends-on 属性 的 Bean 会 优先 销毁 ， 优 于 
被 depends-on 的 Bean 来 销 贷 ， 这 样 depends-on 可 以 控制 销毁 的 顺序 。 


7.4.4 Lazy-initialized beans 


默认 情况 下 ” ApplicationContext 会 在 实例 化 的 过 程 中 创建 和 配置 所 有 的 单 例 Bean。 总 的 来 
说 ， 这 个 预 初始 化 是 很 不 错 的 。 因 为 这 样 能 及 时 发 现 环境 上 的 一 些 配 置 错误 ， 而 不 是 系统 运 

行 了 很 久之 后 才 发 现 。 如 果 这 个 行为 不 是 迫切 需要 的 ， 开 发 者 可 以 通过 将 Bean 标 记 为 延迟 加 
ree 个 预 初 始 化 。 延 迟 初 始 化 的 Bean 会 通知 loC 不 要 让 Bean 预 初始 化 而 是 在 被 引用 
的 时 候 才 会 实例 化 。 在 XML 中 ， 可 以 通过 <bean/> THA lazy-init 属性 来 控制 这 个 行为 。 
如 下 : 


<bean id="lazy" class="com.foo.ExpensiveToCreateBean" lazy-init="true"/> 
<bean name="not.lazy" class="com.foo.AnotherBean"/> 


当 将 Bean 配 置 为 上 面 的 XML 的 时 候 ， applicationcontext 之 中 的 lazy Bean 是 不 会 随 
着 Applicationcontext 的 启动 而 进入 到 预 初始 化 状态 的 ， 而 那些 非 延 迟 加 载 的 Bean 是 处 于 巴 
初始 化 的 状态 的 。 


然而 ， 如 果 一 个 延迟 加 载 的 类 是 作为 一 个 单 例 非 延 迟 加 载 的 Bean 的 依赖 而 存在 的 

话 ， Applicationcontext 仍然 会 在 Applicationcontext 启动 的 时 候 加 载 ， 因 为 作为 单 例 Bean 
的 依赖 ， 会 随 着 单 例 Bean 的 实例 化 而 实例 化 。 开 发 者 可 以 通过 使 用 <beans/> 的 default- 
lazy-init 属性 来 在 容器 层次 控制 Bean 是 否 延 迟 初 始 化 ， 比 如 : 


<beans default-lazy-init="true"> 
<!-- no beans will be pre-instantiated... --> 
</beans> 


7.4.5 Autowiring collaborators 


Spring 容器 可 以 根据 Bean 之 问 的 依赖 关系 自动 装配 。 开 发 者 可 以 令 Spring 通 
过 Applicationcontext 来 来 自动 解析 这 些 关联 。 自 动 的 装载 有 很 多 的 优点 : 


。 自动 装载 能 够 明显 的 减少 指定 的 属性 或 者 是 构造 参数 。 

。 自动 装载 可 以 扩展 开发 者 的 对 象 。 比 如 说 ， 如 果 开 发 者 需要 加 一 个 依赖 ， 依 赖 就 能 够 不 
需要 开发 者 特别 关心 更 改 配置 就 能 够 自动 满足 。 这 样 ， 自 动 装载 在 开发 过 程 中 是 极度 高 
效 的 ， 不 用 明确 的 选择 装载 的 依赖 会 使 系统 更 加 的 稳定 。 


当 使 用 基于 XML 的 元 数据 配置 的 时 候 ， 开 发 者 可 以 指定 自动 装配 的 方式 。 通 过 配 
置 <bean/> 元 素 的 autowire 属性 就 可 以 了 。 自 动 装载 有 如 下 四 种 方式 ， 开 发 者 可 以 指定 每 个 
Bean 的 装载 方式 ， 这 样 Bean 就 知道 如 何 加 载 自 己 的 依赖 。 


模式 解释 
(RU) 不 装载 。Bean 的 引用 必须 通过 ref 元 素来 指定 。 对 于 比较 大 项 目的 
no 部 署 ， 不 建议 修改 默认 的 配置 ， 因 为 特 指 会 加 剧 控制 。 在 某 种 程度 上 来 说 ， 


默认 的 形式 也 说 明了 系统 的 结构 。 


通过 名 字 来 装配 。Spring 会 查找 所 有 的 Bean 直 到 名 字 和 属性 相同 的 一 个 Bean 
来 进行 装载 。 比 如 说 ， 如 果 Bean 配 置 为 根据 名 字 来 自动 装配 ， 它 包含 了 一 个 
属性 名 字 为 master (也 就 是 包含 一 个 setmaster(..) 方法 )，Spring 就 会 查找 
名 字 为 master 的 Bean， 然 后 用 之 装载 


如 果 需 要 自动 装配 的 属性 的 类 型 在 容器 之 中 存在 的 话 ， 就 会 自动 装配 。 如 果 

byType 容器 之 中 存在 不 止 一 个 类 型 匹配 的 话 ， 就 会 抛 出 一 个 重大 的 异 第 ， 说 明 开 发 
者 最 好 不 要 使 用 byType 来 自动 装配 那个 Bean。 如 果 没 有 匹配 的 Bean 存 在 的 
话 ， 不 会 抛 出 异常 ， 只 是 属性 不 会 配置 。 


构造 函 类 似 于 byTyYype 的 注入 ， 但 是 应 用 的 构造 函数 的 参数 。 如 果 没 有 一 个 Bean 的 类 
数 型 和 构造 函数 参数 的 类 型 一 致 ， 那 么 仍然 会 抛 出 一 个 重大 的 异常 


byName 


通过 byType RA 构造 函数 的 自动 装配 方式 ， 开 发 者 可 以 装载 数组 和 强 类 型 集合 。 在 如 此 的 
例子 之 中 ， 所 有 容器 之 中 的 匹配 指定 类 型 的 Bean 会 自动 装配 到 Bean 上 来 完成 依赖 注入 。 开 发 
者 可 以 自动 装配 key 为 string 的 强 类 型 的 map 。 自 动 装配 的 map 值 会 包含 所 有 的 Bean 实 例 
值 来 匹配 指定 的 类 型 ， map 的 key 会 包含 关联 的 Bean 的 名 字 。 


Limitations and disadvantages of autowiring 


自动 装载 如 果 在 整个 的 项 目的 开发 过 程 中 使 用 ， 会 工作 的 很 好 。 但 是 如 果 不 是 全 局 使 用 ， 而 
只 是 用 之 来 自动 装配 几 个 Bean 的 话 ， 会 很 容易 迷惑 开发 者 。 


下 面 是 一 些 自动 装配 的 劣势 和 限制 


e 精确 的 property 以 及 constructor-arg 参数 配置 ， 会 禾 盖 掉 自 动 装配 的 配置 。 开 发 不 能 
够 自动 装配 所 谓 的 简单 属性 ， 比 如 primitive 类 型 或 者 字符 串 。 

© 自动 装配 并 有 精确 装配 准确 。 尽 管 如 上 面 的 表 所 描述 ，Spring 会 尽量 小 心 来 避免 不 必要 的 
错误 装配 ， 但 是 Spring 管理 的 对 象 关 系 仍然 不 如 文档 描述 的 那么 精确 。 

。 装配 的 信息 对 开发 者 可 见 性 不 好 ， 因 为 这 一 切 都 由 Spring 容器 管理 。 

。 容器 中 的 可 能 会 存在 很 多 的 Bean 匹 配 Setter 方 法 或 者 构造 参数 。 比 如 说 数组 ， 集 合 或 者 
Map 等 。 然 而 依赖 却 希 望 仅仅 一 个 匹配 的 值 ， 含 糊 的 信息 是 无 法 解析 的 。 如 果 没 有 独 一 
无 二 的 Bean， 那 么 就 会 抛 出 异常 。 


在 后 面 的 场景 ， 开 发 者 有 如 下 的 选择 


© 放弃 自动 装配 有 利于 精确 装配 

e 可 以 通过 配置 autowire-candidate 属性 为 false 来 阻止 自动 装配 

e 通过 配置 <bean/> 元 素 的 primary 属性 为 true 来 指定 一 个 bean 为 主要 的 候选 Bean 
© 实现 更 多 的 基于 注解 的 细 粒 度 的 装配 配置 。 


Excluding a bean from autowiring 


在 每 个 Bean 的 基础 之 上 ， 开 发 者 可 以 阻止 Bean 来 自动 装配 。 在 基于 XML 的 配置 中 ， 可 以 配 
置 <bean/> 元 素 的 autowire-candidate 属性 为 false 来 做 到 这 一 点 。 容 器 在 读 取 到 这 个 配置 
后 ， 会 让 这 个 Bean 对 于 自动 装配 的 结构 中 不 可 见 (包括 注解 形式 的 配置 比如 @autowired ) 


开发 者 可 以 通过 模式 匹配 而 不 是 Bean 的 名 字 来 限制 自动 装配 的 候选 者 。 最 上 层 的 <beans/> 元 
素 会 在 default-autowire-candidates 属性 中 来 配置 多 种 模式 。 比 如 ， 限 制 自 动 装配 候选 者 的 
名 字 以 Repository 结 尾 ， 可 以 配置 *Repository 。 如 果 需 要 配置 多 种 模式 ， 只 需要 用 过 号 分 隔 
开 即 可 。 当 然 Bean 中 如 果 配 置 了 autowire-candidate 的 话 ， 这 个 信息 拥有 更 高 的 优先 级 。 


上 面 的 这 些 技术 在 配置 那些 不 需要 自动 装配 的 Bean 是 很 有 效 的 。 当 然 这 并 不 是 说 这 类 Bean 本 
身 无 法 自动 装配 其 他 的 Bean， 而 是 说 这 些 Bean 不 在 作为 自动 装配 依赖 的 候选 了 。 


7.4.6 Method injection 


在 大 多 数 的 应 用 场景 下 ， 大 多 数 的 Bean 都 是 单 例 的 。 当 这 个 单 例 的 Bean 需 要 和 另 一 个 单 例 的 
或 者 非 单 例 的 Bean 联 合 使 用 的 时 候 ， 开 发 者 只 需要 配置 依赖 的 Bean 为 这 个 Bean 的 属性 即 

可 。 但 是 有 时 会 因为 不 同 的 Bean 生 命 周期 的 不 同 而 产生 问题 。 假 设 单 例 的 Bean A 在 每 个 方法 
调用 中 使 用 了 非 单 例 的 Bean B。 容 器 只 会 创建 Bean A 一 次 ， 而 只 有 一 个 机 会 来 配置 属性 。 那 
么 容器 就 无 法 给 Bean A 每 次 都 提供 一 个 新 的 Bean B 的 实例 。 


一 个 解决 方案 就 是 放弃 一 些 loOC。 开 发 者 可 以 通过 实现 applicationcontextaware 接口 令 Bean 
A 可 以 看 到 Applicationcontext ， 从 而 通过 调用 getBean("B") 来 在 Bean A 需要 新 的 实例 的 时 
候 来 获取 到 新 的 B 实 例 。 参 考 下 面 的 例子 


// a Class that uses a stateful Command-style class to perform some processing 


package fiona.apple; 


// Spring-API imports 

import org.springframework.beans.BeansException; 

import org.springframework.context.ApplicationContext; 
import org.springframework.context.ApplicationContextAware; 


public class CommandManager implements ApplicationContextAware { 
private ApplicationContext applicationContext; 


public Object process(Map commandState) { 
// grab a new instance of the appropriate Command 
Command command = createCommand(); 
// set the state on the (hopefully brand new) Command instance 
command.setState(commandState); 
return command.execute(); 


protected Command createCommand() { 
// notice the Spring API dependency! 
return this.applicationContext.getBean("command", Command.class); 


public void setApplicationContext( 
ApplicationContext applicationContext) throws BeansException { 
this.applicationContext = applicationContext; 


上 面 的 代码 并 不 是 让 人 十 分 满意 ， 因 为 业务 的 代码 已 经 与 Spring 框架 耦合 在 了 一 起 。Spring 提 
供 了 一 个 稍微 高 级 的 点 特性 方法 注入 的 方式 ， 可 以 用 来 处 理 这 种 问题 。 


Lookup method injection 


查找 方法 注入 就 是 容器 一 种 覆盖 容器 管理 Bean 的 方法 ， 来 返回 查找 的 另 一 个 容器 中 的 Bean 的 
能 力 。 查 找 方 法 通常 就 包含 前 a 景 景 提 到 的 Bean ° SEE 生成 的 字 节 
码 来 动态 生成 子 类 来 履 盖 父 类 的 方法 实现 方法 注入 。 


e 为 了 让 这 个 动态 的 子 类 方案 正常 ， 那 么 Spring 容器 所 需要 继承 的 这 个 Bean 不 能 
是 final a ， MRAD ALLA Be final 的 。 
© 针对 这 个 类 的 单元 测试 因为 存在 抽象 方法 ， 所 以 必须 实现 子 类 来 测试 
° ae 的 所 需 的 具体 方法 也 需要 具体 类 。 
© 一 个 关键 的 限制 在 于 查找 方法 与 工厂 方法 是 不 能 协同 工作 的 ， 尤 其 是 不 能 和 配置 类 
之 中 的 @Bean 的 方法 ， 因 为 容器 不 在 负责 创建 实例 ， 而 是 创建 一 个 运行 时 的 子 类 。 
o 最 后 ， 被 注入 的 到 方法 的 对 象 不 能 被 序列 化 。 


看 到 前 面 的 代码 片段 中 的 commandManager 类 ， 我 们 发 现 发 现 Spring 容 器 会 动态 的 履 
盖 createCommand() 方法 。 CommandManager 类 不 在 拥有 任何 的 Spring 依 赖 7 : 


package fiona.apple; 
// no more Spring imports! 
public abstract class CommandManager { 


public Object process(Object commandState) { 
// grab a new instance of the appropriate Command interface 
Command command = createCommand(); 
// set the state on the (hopefully brand new) Command instance 
command.setState(commandState) ; 
return command.execute(); 


// okay... but where is the implementation of this method? 
protected abstract Command createCommand(); 


在 包含 需要 注入 的 方法 的 客户 端 类 当中 ， 注 入 的 方法 需要 有 如 下 的 函数 签名 


<public|protected> [abstract] <return-type> theMethodName(no-arguments) ; 


如 果 方 法 为 抽象 ， 那 


么 动态 生成 的 子 类 会 实现 这 个 方法 。 否 则 ， 动 态 生 成 的 子 类 会 覆盖 类 中 
的 定义 的 原 方法 。 例 如 : 


<!-- a stateful bean deployed as a prototype (non-singleton) --> 

<bean id="command" class="fiona.apple.AsyncCommand" scope="prototype"> 
<!-- inject dependencies here as required --> 

</bean> 


<!-- commandProcessor uses statefulCommandHelper --> 
<bean id="commandManager" class="fiona.apple.CommandManager"> 


<lookup-method name="createCommand" bean="command"/> 
</bean> 


上 面 的 commandManager 在 当 它 需 要 一 个 command Bean 实 例 的 时 候 就 会 调用 自己 的 方 
法 createCommand() 。 tea E command Bean 的 为 prototype 类 型 的 Bean。 如 果 
所 需 的 Bean 为 单 例 的 ， 那 么 这 个 方法 注入 返回 的 将 都 是 同一 个 实例 。 


Arbitrary method replacement 


从 前 面 的 描述 a 能 力 来 覆盖 任何 由 容器 管理 的 Bean 的 方法 的 。 开 发 
者 最 好 跳 过 这 > 除非 一 定 需 要 使 用 这 个 功能 。 


通过 配置 基于 XML 的 配置 元 数据 ， 开 发 者 可 以 使 用 replaced-method 元 素来 蔡 换 一 个 存在 的 方 
法 的 实现 o 考虑 如 下 情 况 : 


public class MyValueCalculator { 


public String computeValue(String input) { 
// some real code... 


// some other methods... 


一 个 实现 了 org.springframework.beans.factory.support .MethodReplacer 接口 的 类 会 提供 一 个 
新 方法 的 定义 。 


FIR 


* meant to be used to override the existing computeValue(String) 
* implementation in MyValueCalculator 
A 


public class ReplacementComputeValue implements MethodReplacer { 


public Object reimplement(Object o, Method m, Object[] args) throws Throwable { 
// get the input value, work with it, and return a computed result 
String input = (String) args[0]; 


return .. 


ee 


如 果 需 要 夫 盖 Bean 的 方法 需要 配置 XML 如 下 : 


<bean id="myValueCalculator" class="x.y.z.MyValueCalculator"> 
<!-- arbitrary method replacement --> 


<replaced-method name="computeValue" replacer="replacementComputeValue"> 
<arg-type>String</arg-type> 
</replaced-method> 
</bean> 


<bean id="replacementComputeValue" class="a.b.c.ReplacementComputeValue"/> 


FRAT 以 使 用 更 多 的 <replaced-method> 中 的 <arg=type/> 元 素来 指定 需要 履 盖 的 方法 ° 4 
需要 履 盖 的 方法 存在 重 载 方法 时 ， 指 定 参数 才 是 必须 的 。 为 了 方便 起 见 ， 字 符 串 的 类 型 是 会 
匹配 如 下 类 型 ， 完 全 等 同 于 java.lang.String ° 


java.lang.String 
String 
Str 


因为 通常 来 说 参数 的 个 数 已 经 足够 区 别 不 同 的 方法 了 ， 这 种 快捷 的 写法 可 以 省 去 很 多 的 代 
Aly o 


Bean scopes 


当 开 发 者 定义 Bean 的 时 候 ， 同 时 也 会 定义 了 该 如 何 创建 Bean 实 例 。 这 些 具体 创建 的 过 程 是 很 

重要 的 ， 因 为 只 有 通过 对 这 些 过 程 的 配置 ， 开 发 者 才能 创建 实例 对 象 。 

开发 者 不 仅 可 以 控制 注入 不 同 的 依赖 到 Bean 之 中 ， 也 可 以 配置 Bean 的 作用 域 。 这 种 方法 是 非 
常 强大 而 且 弹 性 也 非常 好 的 。 开 发 者 可 以 通过 配置 来 指定 对 象 的 作用 域 ， 而 不 用 在 Java 类 层 


次 上 来 配置 。Bean 可 以 配置 多 种 作用 域 。 Spring 框架 支持 5 种 作用 域 ， 有 三 种 作用 域 是 当 开 
发 者 使 用 基于 web 的 applicationcontext 的 时 候 才 生效 的 。 


下 面 就 是 Spring 直接 支持 的 作用 域 了 ， 当 然 开 发 者 也 可 以 自己 定制 作用 域 。 


作用 域 
单 例 > y= Ne k ER : ee 
(singleton) (默认 ) 每 一 个 Spring loC 容 器 都 拥有 唯一 的 一 个 实例 对 象 
原型 

(prototype ) 一 个 Bean 定 义 可 以 创建 任意 多 个 实例 对 象 


一 个 HTTP 请 求 会 产生 一 个 Bean 对 象 ， 也 就 是 说 ， 每 一 个 HTTP 请 求 者 


+ E 

3 有 自己 的 Bean 实 例 。 只 在 基于 web 的 Spring Applicationcontext 中 可 
request ) 用 

会 话 限定 一 个 Bean 的 作用 域 为 HTTP session 的 生命 周期 。 同 样 ， 只 有 基于 
(session ) web 的 Spring Applicationcontext 才能 使 用 

会 局 会 

a 限定 一 个 Bean 的 作用 域 为 全 局 HTTP session 的 生命 周期 。 通 常用 于 门 
glo a 户 网 站 场景 ， 同 样 ， 只 只 有 基于 web 的 Spring ApplicationContext 可 用 

session ) 

应 用 限定 一 个 Bean 的 作用 域 为 servletcontext 的 生命 周期 。 同 样 ， 只 有 基 


(application) 于 web 的 Spring applicationcontext 可 用 


在 Spring 3.0 中 ， 线 程 作用 域 是 可 用 的 ， 但 不 是 默认 注册 的 。 想 了 解 更 多 的 信息 ， 可 以 参 
考 本 文 后 面 关 于 simpleThreadscope 的 文档 。 想 要 了 解 如 何 注册 这 个 或 者 其 他 的 自 定义 的 
作用 域 ， 可 以 参考 后 面 的 内 容 。 


The singleton scope 


xm 


— 


单 例 Bean 全 局 只 有 一 个 共享 的 实例 ， 所 有 将 单 例 Bean 作 为 依赖 的 情况 下 ， 容 器 返回 将 是 
个 实例 。 

换言之 ， 当 开发 者 定义 一 个 Bean 的 作用 域 为 单 例 时 ，Spring loC 容 器 只 会 根据 Bean 定 义 来 创 
建 该 Bean 的 唯一 实例 。 这 些 唯 一 的 实例 会 缓存 到 容器 中 ， 后 续 针 对 单 例 Bean 的 请 求 和 引用 ， 
都 会 从 这 个 缓存 中 拿 到 这 个 唯一 的 实例 。 


Bean 作 用 域 


Only one instance is ever created... 





Spring 的 单 例 Bean 和 与 设计 模式 之 中 的 所 定义 的 单 例 模 式 是 有 所 区 别 的 。 设 计 模 式 中 的 单 例 

模式 是 将 一 个 对 象 的 作用 域 硬 编码 的 ， 一 个 ClassLoader 只 有 唯一 的 一 个 实例 。 而 Spring 的 单 
例 作 用 域 ， 是 基于 每 个 容器 ， 每 个 Bean 只 有 一 个 实例 。 这 意味 着 ， 如 果 开 发 者 根据 一 个 类 定 

义 了 一 个 Bean 在 单个 的 Spring 容器 中 ， 那 么 Spring 容器 会 根据 Bean 定 义 创建 一 个 唯一 的 Bean 
实例 。 单 例 作用 域 是 Spring 的 默认 作用 域 ， 下 面 的 例子 是 在 基于 XML 的 配置 中 配置 单 例 模 式 

的 Bean。 


<bean id="accountService" class="com.foo.DefaultAccountService"/> 


<!-- the following is equivalent, though redundant (singleton scope is the default) -- 
> 


<bean id="accountService" class="com.foo.DefaultAccountService" scope="sSingleton"/> 


The prototype scope 


非 单 例 的 ， 原 型 的 Bean 指 的 就 是 每 次 请 求 Bean 实 例 的 时 候 ， 返 回 的 都 是 新 实例 的 Bean 对 

象 。 也 就 是 说 ， 每 次 注入 到 另外 的 Bean 或 者 通过 调用 getBean() 来 获得 的 Bean 都 将 是 全 新 的 
实例 。 这 是 基于 线程 安全 性 的 考虑 ， 如 果 使 用 有 状态 的 Bean 对 象 用 原型 作用 域 ， 而 无 状态 的 
Bean 对 象 用 单 例 作用 域 。 


下 面 的 例子 说 明了 Spring 的 原型 作用 域 。DAO 通 常 不 会 配置 为 原型 对 象 ， 因 为 典型 的 DAO 是 
不 会 有 任何 的 状态 的 。 
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Bean 作 用 域 


ee A brand new bean instance is created... | brand new bean A brand new bean instance is created... | is created... 
scope="prototype" /> 


re 


... each and every time the prototype is referenced by collaborating beans 





下 面 的 例子 展示 了 XML 中 如 何 定义 一 个 原型 的 Bean : 


<bean id="accountService" class="com.foo.DefaultAccountService" scope="prototype"/> 


与 其 他 的 作用 域 相 比 ，Spring 是 不 会 完全 管理 原型 Bean 的 生命 周期 的 : Spring 容器 只 全 

化 ， 配 置 以 及 装载 这 些 Bean， 传 递 给 Client。 但 是 之 后 就 不 会 再 去 管 原型 Bean 之 后 的 动作 
了 。 也 就 是 说 ， 初 始 化 生命 周期 回调 方法 在 所 有 作用 域 的 Bean 是 都 会 调用 的 ， 但 是 销毁 生命 
周期 回调 方法 在 原型 Bean 是 不 会 调用 的 。 所 以 ， 客 户 端 代码 必须 注意 清理 原型 Bean 以 及 释放 
原型 Bean 所 持 有 的 一 些 资 源 。 可 以 通过 使 用 自 定 义 的 bean post-processor 来 让 Spring 释放 掉 
原型 Bean 所 持 有 的 资源 。 


在 某 些 方面 来 说 ，Spring 容 器 的 角色 就 是 取代 了 Java 的 new 操作 符 ， 所 有 的 生命 周期 的 控制 
需要 由 客户 端 来 处 理 。 


Singleton beans with prototype-bean dependencies 


当 使 用 单 例 Bean 的 时 候 ， 而 该 单 例 Bean 的 依赖 是 原型 Bean 的 时 候 ， 需 要 注意 的 是 依赖 的 解 
析 都 是 在 初始 化 的 阶段 的 。 因 此 ， 如 果 将 原型 Bean 注 入 到 单 例 的 Bean 之 中 ， 只 会 请 求 一 次 原 
型 的 Bean， 然 后 注入 到 单 例 的 Bean 之 中 。 这 个 依赖 的 原型 Bean 仍 然 属 于 只 有 一 个 实例 的 。 


然而 ， 假 设 你 需要 单 例 Bean 对 原型 的 Bean 的 依赖 需要 每 次 在 运行 时 都 请 求 一 个 新 的 实例 ， 那 
么 你 就 不 能 够 将 一 个 原型 的 Bean 来 注入 到 一 个 单 例 的 Bean 当 中 了 ， 因 为 依赖 注入 只 会 进行 一 
次 。 当 Spring 容器 在 实例 化 单 例 Bean 的 时 候 ， 就 会 解析 以 及 注入 它 所 需 的 依赖 。 如 果实 在 需 
要 每 次 都 请 求 一 个 新 的 实例 ， 可 以 参考 Dependencies 中 的 方法 注入 部 分 。 


Request, session, global session, application, and 
WebSocket scopes 


request , session 以 及 global session 这 三 个 作用 域 都 是 只 有 在 基于 Web 的 

Spring ApplicationContext 实现 的 (比如 XmlwebApplicationContext ) 中 才能 使 用 。 如 果 开 发 
者 仅仅 在 常 规 的 Spring loC 容 器 中 比如 ClassPathxmlApplicationContext 中 使 用 这 些 作用 域 ， 
那么 将 会 抛 出 一 个 IllegalstateException 来 说 明 使 用 了 未 知 的 作用 域 。 


Initial web configuration 


为 了 能 够 使 用 request , session 以 及 global session 作用 域 (web i CA 4) Bean ) ,需要 在 配 
置 Bean 之 前 配置 做 一 些 基 础 的 配置 。 (对 于 标准 的 作用 域 ， 比 如 singleton 以 
及 prototype ， 是 无 需 这 些 基础 的 配置 的 ) 


具体 如 何 配置 取决 于 Servlet 的 环境 。 


比如 如 果 开 发 者 使 用 了 Spring Web MVC 框 架 的 话 ， 每 一 个 请 求 会 通过 Spring 
的 DispatcherServlet 或 者 DispatcherPortlet 来 处 理 的 ， 也 就 没有 其 他 特殊 的 初始 化 配 
置 。 DispatcherServlet 和 DispatcherPortlet 已 经 包含 了 相关 的 状态 。 


如 果 使 用 Servlet 2.5 的 web 容 器 ， 请 求 不 是 通过 Spring 的 Dispatcherservlet (比如 JSF 或 者 
Struts) 来 处 理 。 那 么 开发 者 需要 注 

册 org.springframework.web.context.request.RequestContextListener 或 

者 ServletRequestListener 。 而 在 Servlet 3.0 以 后 ， 这 些 都 能 够 通 

过 WebApplicationInitializer 接口 来 实现 。 或 者 ， 如 果 是 一 些 旧 版 本 的 容器 的 话 ， 可 以 

在 web.xml 中 增加 如 下 的 Listener 声 明 : 


<web-app> 


<listener> 
<listener-class> 
org.springframework.web.context.request .RequestContextListener 
</listener-class> 
</listener> 


</web -app> 


如 果 是 对 Listener 不 其 熟悉 ， 也 可 以 考虑 使 用 Spring 的 RequestContextFilter 。Filter 的 映射 取 
决 于 web 应 用 的 配置 ， 开 发 者 可 以 根据 如 下 例子 进行 适当 的 修改 。 


<web-app> 


<filter> 
<filter -name>requestContextFilter</filter -name> 
<filter-class>org.springframework.web. filter .RequestContextFilter</filter-clas 
s> 
</filter> 
<filter -mapping> 
<filter -name>requestContextFilter</filter -name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


</web -app> 


DispatcherServlet ? RequestContextListener 以 及 RBS Sa 做 的 本 质 上 完全 一 
致 ， 都 是 绑 定 request 对 象 到 服务 请 求 的 Thread 上 。 这 才 使 得 Bean 在 之 后 的 调用 链 上 在 请 求 
和 会 话 范围 上 可 见 


Request scope 


参考 如 下 的 Bean 定 义 


<bean id="loginAction" class="com.fo0o0.LoginAction" scope="request"/> 


Spring 容器 会 在 每 次 用 到 loginaction 来 处 理 每 个 HTTP 请 求 的 时 候 都 会 创建 一 个 新 

的 LoginAction 实例 。 也 就 是 说 ， loginAction Bean 的 作用 域 是 HTTP Request 级 别 的 。 开 
发 者 可 以 随意 改变 实例 的 状态 ， 因 为 其 他 通过 loginAction 请 求 来 创建 的 实例 根本 看 不 到 开发 
者 改变 的 实例 状态 ， 所 有 创建 的 Bean 实 例 都 是 根据 独立 的 请 求 来 的 。 当 请 求 处 理 完毕 ， 这 个 
Bean 也 会 销毁 。 


Session scope 


参考 如 下 的 Bean 定 义 : 


<bean id="userPreferences" class="com.foo.UserPreferences" scope="session"/> 


Spring 容器 会 在 每 次 调用 到 userpreferences 在 一 个 单独 的 HTTP 会 话 周期 来 创建 一 个 新 

的 Userpreferences 实例 。 换 言 之 ， userPreferences Bean 的 作用 域 是 HTTP Session 级 别 

的 。 在 request-scoped 作用 域 的 Bean 上 ， 开发 者 可 以 随意 的 更 改 实例 的 状态 ， 同样 ， 其 他 的 
HTTP session 基本 的 实例 在 每 个 Session 都 会 请 求 userpreferences 来 创建 新 的 实例 ， 所 以 开 
o ， ee 然 是 不 可 见 的 。 当 HTTP session HAT > MAR 
据 这 个 session 来 创建 的 Bean 也 就 销毁 了 。 


Global session scope 
该 部 分 主要 是 描述 portlet 的 ， 详 情 可 以 Google 更 多 关于 portlet 的 相关 信息 


参考 如 下 的 Bean 定 义 : 


<bean id="userPreferences" class="com.foo.UserPreferences" scope="globalSession"/> 


global session 作用 域 比 较 类 似 之 前 提 到 的 标准 的 HTTP session ， 这 种 作用 域 是 只 应 用 于 基 
于 门户 (portlet-based) 的 web 应 用 的 上 下 之 中 的 。 门 户 的 Spec 中 定义 的 global session 的 
意义 : global session 被 所 有 构成 门户 的 web 应 用 所 共享 。 定 义 为 global session 作用 域 的 
Bean 是 作用 在 全 局 门户 session 的 声明 周期 的 。 


如 果 在 使 用 标准 的 基于 Servlet 的 Web 应 用 ， 而 且 定 义 了 global session 作用 域 的 Bean， 那 么 
只 是 会 使 用 标准 的 HTTP session 作用 域 ， 不 会 报错 。 


Application scope 


考虑 如 下 的 Bean 定 义 : 


<bean id="appPreferences" class="com.foo.AppPreferences" scope="application"/> 


Spring 容 器 会 在 整个 web 应 用 使 用 到 appPreferences 的 时 候 创 | 建 一 个 新 的 AppPreferences 的 
实例 。 也 就 是 说 ， AE TENCE Bean 是 在 servletcontext 级 别 的 ， 好 似 一 个 普通 

的 Servletcontext 属性 一 样 。 这 种 作用 域 在 一 些 程度 上 来 说 和 Spring 的 单 例 | 作用 域 是 极为 相 
似 的 ， 但 是 也 有 如 下 不 同 之 处 : 


@ application 作用 域 是 每 个 I~ ServletContext 中 包 含 一 个 ， > 而 不 是 每 个 | 
Spring applicationcontext 之 中 包含 一 个 〈 某 er 包含 不 止 一 
AN ApplicationContext ) ° 

@ application 作用 域 仅仅 作为 ServletContext 的 属性 可 见 ， 单 例 Bean 


是 ApplicationContext 可 见 


Scoped beans as dependencies 


Spring loC 容 器 不 仅仅 管理 对 象 (Bean) 的 实例 化 ， 同 时 也 负责 装载 依赖 。 如 果 开 发 者 想 装 
载 一 个 Bean 到 一 个 作用 域 更 广 的 Bean 当 中 去 (比如 HTTP 请 求 返回 的 Bean ) ,那么 开发 者 选择 
注入 一 个 AOP 代 理 而 不 是 短 作用 域 的 Bean。 也 就 是 说 ， 开 发 者 需要 注入 一 个 代理 对 象 ， 这 个 
代理 对 象 既 可 以 找到 实际 的 Bean， 也 能 够 创建 一 个 全 新 的 Bean 。 


开发 者 会 在 单 例 Bean 中 使 用 <aop:scoped-proxy/> 标签 ， 来 引用 一 个 代理 ， 这 个 代理 的 作 
用 就 是 用 来 获取 指定 的 Bean。 当 声 明 使 用 <aop:scoped-proxy/> 来 生成 一 个 原型 Bean 的 

时 候 ， 每 个 通过 代理 的 调用 都 会 产生 一 个 新 的 目标 实例 。 并 且 ， 作 用 域 代 理 并 不 是 唯一 

来 获取 短 作 用 域 Bean 的 唯一 安全 的 方式 。 开 发 者 也 可 以 通过 简单 的 声明 注入 

为 objectFactory<MyTargetBean>， 多 许 通过 类 似 getObject() 之 类 的 调用 来 获取 一 些 指定 的 依赖 ， 而 不 

是 直接 储存 依赖 的 实例 。 JSR-330 关 于 这 部 分 的 名 称 不 同 叫做 Provider ， 通 过 使 用 Provider 声 明和 一 个 
相关 的 get() 方法 来 获取 指定 的 依赖 。 详 细 关 于 JSR-330 的 信息 可 以 进去 详细 了 解 。 


请 参考 下 面 的 例子 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http: //www.w3.org/2001/XMLSchema- instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans. xsd 
http://www. springframework.org/schema/aop 
http://www. springframework.org/schema/aop/spring-aop.xsd"> 


<!-- an HTTP Session-scoped bean exposed as a proxy --> 
<bean id="userPreferences" class="com.foo.UserPreferences" scope="Session"> 
<!-- instructs the container to proxy the surrounding bean --> 


<aop: scoped-proxy/> 


</bean> 
<!-- a singleton-scoped bean injected with a proxy to the above bean --> 
<bean id="userService" class="com.foo.SimpleUserService"> 

<!-- a reference to the proxied userPreferences bean --> 


<property name="userPreferences" ref="userPreferences"/> 
</bean> 
</beans> 


使 用 代理 ， 只 需要 在 短 作 用 域 的 Bean 定 义 之 中 加 入 一 个 子 节点 <aop:scoped-proxy/> BP 
可 。Dependencies 中 的 方法 注入 中 就 提 及 到 了 Bean 依 赖 的 一 些 问 题 ， 这 也 是 我 们 为 什么 要 使 
用 aop 代理 的 原因 。 假 设 我 们 没有 使 用 aop 代理 而 是 直接 进行 依赖 注入 ， 参 考 如 下 的 例子 : 


<bean id="userPreferences" class="com.foo.UserPreferences" scope="Session"/> 


<bean id="userManager" class="com.foo.UserManager"> 
<property name="userPreferences" ref="userPreferences"/> 


</bean> 


上 面 的 例子 中 ， usermanager 明显 是 一 个 单 例 的 Bean， 注 入 了 一 个 HTTP Session 级 别 

的 userPreferences 依赖 ， 显 然 的 问题 就 是 userManager 在 Spring 容器 中 只 会 实例 化 一 次 ， 而 
依赖 (当前 例子 中 的 userPreferences ) 也 只 能 注入 一 次 。 这 也 就 意味 着 usermanager 每 次 使 用 
的 都 是 相同 的 userpreferences 对 象 。 


那么 这 种 情况 就 绝对 不 是 开发 者 想 要 的 那 种 将 短 作 用 域 注 入 到 长 作用 域 Bean 中 的 情况 了 ， 举 
例 来 说 ， 注 入 一 个 HTTP session 级 别 的 Bean 到 一 个 单 例 之 中 ， 或 者 说 ， 当 开发 者 通 
过 userManager 来 获取 指定 与 某 个 HTTP session 的 userpreferences 对 象 都 是 不 可 能 的 。 所 
以 容器 创建 了 一 个 获取 userPreferences 对 象 的 接口 ， 这 个 接口 可 以 根据 Bean 对 象 作 用 域 机 
制 来 获取 与 作用 域 相关 的 对 象 (比如 说 HTTP Request 或 者 HTTP session F) 。 容 器 之 后 注 
ARLES FF userManager 中 ， 而 意识 不 到 所 引用 UserPreferences 是 代理 。 在 这 个 例子 之 
中 ， 当 Usermanager 实例 调用 方法 来 获取 注入 的 依赖 userPreferences 对 象 时 ， 其 实 只 会 调用 
了 代理 的 方法 ， 由 代理 去 获取 丨 正 的 对 象 ， 在 这 个 例子 中 就 是 HTTP Session 级 别 的 Bean 。 


所 以 当 开 发 者 希望 能 够 正确 的 使 用 配置 request , session 或 者 globalsession 级 别 的 Bean 来 
作为 依赖 时 ， 需 要 进行 如 下 的 类 似 配置 : 


<bean id="userPreferences" class="com.foo.UserPreferences" scope="session"> 
<aop: scoped-proxy/> 
</bean> 


<bean id="userManager" class="com.foo.UserManager'"> 
<property name="userPreferences" ref="userPreferences"/> 
</bean> 


选择 代理 的 类 型 


默认 情况 下 ，Spring 容 器 创建 代理 的 时 候 标记 为 <aop:scoped-proxy/> 的 标签 时 ， 会 创建 一 个 
基于 CGLIB 的 代理 。 


CGLIB 代 理会 拦截 public 方法 调用 ! 所 以 不 要 在 非 public 方法 上 使 用 代理 ， 这 样 将 不 
会 获取 到 指定 的 依赖 。 


或 者 ， 开发 者 可 以 通过 指 <aop:scoped-proxy/> 标签 的 proxy-target-class 属性 的 值 

A false 来 配置 Spring 容器 来 为 这 些 短 作用 域 的 Bean 创 建 一 个 标准 JDK 的 基于 接口 的 代理 。 

使 用 JDK 基 于 接口 的 代理 意味 着 开发 者 不 需要 在 应 用 的 路 径 引 用 额外 的 库 来 完成 代理 。 当 然 ， 
这 也 意味 着 短 作 用 域 的 Bean 需 要 额外 实现 一 个 接口 ， 而 依赖 是 从 这 些 接 口 来 获取 的 。 


<!-- DefaultUserPreferences implements the UserPreferences interface --> 

<bean id="userPreferences" class="com.foo.DefaultUserPreferences" scope="sSession"> 
<aop:scoped-proxy proxy-target-class="false"/> 

</bean> 


<bean id="userManager" class="com.foo.UserManager"> 
<property name="userPreferences" ref="userPreferences"/> 
</bean> 


DefaultUserPreferences 实现 了 UserPreferences 而 且 提 供 了 接口 来 获取 实际 的 x RH 2 更 多 的 
言 息 可 以 参考 AOP 代 理 。 


Custom scopes 


Bean 的 作用 域 机 制 是 可 扩展 的 ， 开 发 者 可 以 定义 自己 的 一 些 作用 域 ， 基 至 重新 定义 已 经 存在 
的 作用 域 ， 但 是 这 一 点 Spring 团 队 是 不 推荐 的 ， 并 且 开 发 者 不 能 够 重 写 singleton 以 
及 prototype 作用 域 = 


Creating a custom scope 


为 了 能 够 使 Spring 可 以 管理 开发 者 定义 的 作用 域 ， 开 发 者 需要 实 

现 org.springframework.beans.factory.config.Scope 接口 。 想 知 道 如 何 实现 开发 者 自 己 定 义 的 
作用 域 ， 可 以 参考 Spring 框架 的 一 些 实现 或 者 是 scope 的 javadoc， 里 面 会 解释 开发 者 需要 实 
现 的 一 些 细节 。 


scope 接口 中 含有 4 个 方法 来 获取 对 象 ， 移 除 对 象 ， 允 许 销 毁 等 。 


下 面 的 方法 返回 一 个 存在 的 作用 域 的 对 象 。 比 如 说 session 的 作用 域 实现 ， 该 函数 将 返回 会 
话 作 用 域 的 Bean (如 果 Bean 不 存在 ， 该 方法 会 创建 一 个 新 的 实例 ) 


Object get(String name, ObjectFactory objectFactory) 


下 面 的 方法 会 将 对 象 移 出 作用 域 2 同样 ， YA Session 为 例 该 函数 会 删 除 Session 作用 域 的 
Bean。 删 除 的 对 象 会 作为 返回 值 返 回 ， 当 无 法 找到 对 象 的 时 候 可 以 返回 null © 


Object remove(String name) 


下 面 的 方法 会 注册 一 个 回调 方法 ， 当 需要 销毁 或 者 作用 域 销毁 的 时 候 调 用 。 详 细 可 以 参考 在 
javadoc 和 Spring 作用 域 的 实现 中 找到 更 多 关于 销毁 回调 方法 的 信息 。 


void registerDestructionCallback(String name, Runnable destructionCallback) 


下 面 的 方法 会 获取 作用 域 的 区 分 标识 ， 区 分 标识 区 别 于 其 他 的 作用 域 。 


String getConversationId() 


Using a custom scope 


在 实现 了 开发 者 的 自 定义 作用 域 之 后 ， 开 发 者 还 需要 让 Spring 容器 能 够 识别 发 现 这 个 新 的 作用 
域 。 下 面 的 方法 就 是 在 Spring 容器 中 用 来 注册 新 的 作用 域 的 。 


void registerScope(String scopeName, Scope scope); 


这 个 方法 是 在 ConfigurableBeanFactory 的 接口 中 声 明 的 ， 在 大 多 数 的 ApplicationContext 的 
实现 中 都 是 可 以 用 的 ， 可 以 通过 BeanFactory 属性 来 调用 。 


registerScope(..) 方法 的 第 一 个 参数 是 作用 域 相 关联 的 唯一 的 一 个 名 字 ; 举例 来 说 ， 比 如 
Spring 容器 之 中 的 singleton 和 prototype 就 是 这 样 的 名 字 。 第 二 个 参数 就 是 我 们 根据 Scope 


接口 所 实现 的 具体 的 对 象 。 
假定 开发 者 实现 了 自 定 义 的 作用 域 ， 然 后 按照 如 下 步骤 来 注册 。 


下 面 的 例子 使 用 了 simplethreadscope ， 这 个 例子 Spring 中 是 有 实现 的 ， 但 是 没有 默认 注 





册 。 开 发 者 自 实 现 的 scope 也 可 以 通过 如 下 方式 来 注册 。 


Scope threadScope = new SimpleThreadScope(); 
beanFactory.registerScope("thread", threadScope); 


之 后 ， 开 发 者 可 以 通过 如 下 类 似 的 Bean 定 义 来 使 用 自 定义 的 scope : 


<bean id="..." class="..." scope="thread"> 


在 定制 的 Scope 中 ， 开 发 者 也 不 限于 仅仅 通过 编程 方式 来 注册 自己 的 Scope ， 开发 者 可 以 通 


过 下 面 CustomScopeConfigurer 类 来 实现 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd 
http://www. springframework.org/schema/aop 
http://www. springframework.org/schema/aop/spring-aop.xsd"> 


<bean class="org.springframework.beans.factory.config.CustomScopeConfigurer"> 
<property name="scopes"> 
<map> 
<entry key="thread"> 
<bean class="org.springframework.context.support.SimpleThreadScope 
"/> 
</entry> 
</map> 
</property> 
</bean> 


<bean id="bar" class="x.y.Bar" scope="thread"> 
<property name="name" value="Rick"/> 
<aop:scoped-proxy/> 

</bean> 


<bean id="foo" class="x.y.Foo"> 
<property name="bar" ref="bar"/> 


</bean> 


</beans> 


Customing the nature of a bean 


Lifecycle callbacks 


开发 者 通过 实现 Spring 的 mnitializeingBean 和 DisposableBean 接口 ， 就 可 以 让 容器 来 管理 
Bean 的 生命 周期 。 容 器 会 在 调用 afterpropertiesset() 之 后 和 destroy() 之 前 会 允许 Bean 在 
初始 化 和 销毁 Bean 的 时 候 执行 一 些 操作 。 


JSR-25049 @PostConstruct 和 @PreDestroy 注解 就 是 现代 Spring 应 用 用 生命 周期 回调 的 最 佳 
实践 。 使 用 这 些 注解 意味 着 Bean 不 会 再 耦合 PO 详细 内 容 ， 后 续 将 
会 介绍 。 如 果 开 发 者 不 想 使 用 JSR-250 的 注解 ， 仍 然 可 以 考虑 使 用 init- 

method 和 destroy-method 的 SLR ARAB Spring 接口 


内 部 来 说 ，Spring 框 架 使 用 BeanPostProcessor 的 实现 来 处 理 接口 的 回 

调 ， BeanPostProcessor 能 够 找到 并 调用 合适 的 方法 。 如 果 开 发 者 需要 定制 一 些 Spring 并 不 直 
接 提供 的 生命 周期 行为 ， 开 发 者 可 以 考虑 自行 实现 一 个 BeanPostProcessor 。 更 多 的 信息 可 以 
参考 后 面 的 容器 扩展 点 。 


除了 初始 化 和 销毁 回调 ，Spring 管 理 的 对 象 也 实现 了 Lifecycle 接口 来 让 管理 的 对 象 在 容器 的 
生命 周期 内 启动 和 关闭 。 


生命 周期 回调 在 本 节 会 进行 详细 描述 。 
Initialization callbacks 


org.springframework.beans.factory.InitializingBean 接口 允许 Bean 在 所 有 的 必要 的 依赖 配置 
配置 完成 后 来 执行 初始 化 Bean 的 操作 。 InitializingBean 接口 中 特 指 了 一 个 方法 : 


void afterPropertiesSet() throws Exception; 


Spring 团队 是 建议 开发 者 不 要 使 用 InitializingBean 接口 的 ， 因 为 这 样 会 将 代码 耦合 到 Spring 
的 特定 接口 之 上 。 而 通过 使 用 @postconstruct 注解 或 者 指定 一 个 POJO 的 实现 方法 ， 会 比 实现 
接口 要 更 好 。 在 基于 XML 的 配置 元 数据 上 ， 开 发 者 可 以 使 用 init-method 属性 来 指定 一 个 没有 
参数 的 方法 。 使 用 Java 配 置 的 开发 者 可 以 使 用 @Bean 之 中 的 initmethod 属性 ， 比 如 如 下 : 


<bean id="exampleInitBean" class="examples.ExampleBean" init-method="init"/> 


public class ExampleBean { 


public void init() { 
// do some initialization work 


与 如 下 代码 一 样 效果 : 


<bean id="exampleInitBean" class="examples.AnotherExampleBean"/> 


public class AnotherExampleBean implements InitializingBean { 


public void afterPropertiesSet() { 
// do some initialization work 


但 是 前 一 个 版 本 的 代码 是 没有 耦合 到 Spring 的 。 


Destruction callbacks 


= 


实现 了 org.springframework.beans.factory.DisposableBean 接口 的 Bean 就 能 通 让 容器 通过 回调 
来 销毁 Bean 所 引用 的 资源 。 DisposableBean 接口 包含 了 一 个 方法 : 


void destroy() throws Exception; 


同 InitializingBean 相 类 似 ，Spring 团 队 仍然 不 建议 开发 者 来 实现 DisposableBean 回调 接口 ， 
为 这 样 会 将 开发 者 的 代码 耦合 到 Spring 代码 上 。 换 种 方式 ， 比 如 使 用 @prepestroy 注解 或 者 指 
定 一 个 Bean 支 持 的 配置 方法 ， 比 如 在 基于 XML 的 配置 元 数据 中 ， 开 发 者 可 以 在 Bean 标 签 上 指 
定 destroy-method 属性 。 而 在 基于 Java 配 置 中 2 开发 者 也 可 以 配 

置 @Bean 的 destroyMethod 来 实现 销毁 回调 。 


<bean id="exampleInitBean" class="examples.ExampleBean" destroy-method="cleanup"/> 


public class ExampleBean { 


public void cleanup() { 
// do some destruction work (like releasing pooled connections) 


} 


上 面 的 代码 配置 和 如 下 配置 是 等 同 的 : 


<bean id="exampleInitBean" class="examples.AnotherExampleBean"/> 


public class AnotherExampleBean implements DisposableBean { 


public void destroy() { 
// do some destruction work (like releasing pooled connections) 


} 


但 是 第 一 段 代码 是 没有 耦合 到 Spring 的 。 


<bean/> 标签 的 destroy-method 可 以 被 配置 为 特殊 指定 的 值 ， 来 方便 让 Spring 能 够 自动 
的 检查 到 close 或 者 shutdown 方法 (可 以 实现 java.lang.AutoCloseable 或 

者 java.io.Closeable 都 会 匹配 。) 这 个 特殊 指定 的 值 可 以 配置 到 <beans/> 的 default- 
destroy-method 来 让 所 有 的 Bean 实 现 这 个 行为 。 


Default initialization and destroy methods 


当 开 发 者 不 使 用 Spring 特 有 的 InitializingBean 和 DisposableBean 回调 接口 来 实现 初始 化 和 
销毁 方法 的 时 候 ， 开 发 者 通常 定义 的 方法 名 字 都 是 好 似 init() ， initialize() 或 者 

是 dispose() 等 等 。 那 么 ， 可 以 将 这 类 的 方法 在 项 目 中 标准 化 ， 来 让 所 有 的 开发 者 都 使 用 一 
样 的 名 字 来 确保 一 致 性 。 


开发 者 可 以 配置 Spring 容器 来 针对 每 一 个 Bean 都 查找 这 种 名 字 的 初始 化 和 销毁 回调 函数 。 也 
就 是 说 ， 任 何 的 一 个 应 用 开发 者 ， 都 会 在 应 用 的 类 中 使 用 一 个 叫 init() 的 初始 化 回调 ， 而 不 
需要 在 每 个 Bean 中 定义 init-method="init" 这 中 属性 。Spring loC 容 器 会 在 Bean 创 建 的 时 候 
调用 那个 方法 (就 如 前 面 描述 的 标准 生命 周期 一 样 。) 这 个 特性 也 将 强制 开发 者 为 其 他 的 初 
始 化 以 及 销毁 回调 函数 使 用 同样 的 名 字 。 


假设 开发 者 的 初始 化 回调 方法 名 字 为 init() 而 销毁 的 回调 方法 为 destroy() 。 那 么 开发 者 的 
类 就 会 好 似 如 下 的 代码 : 


public class DefaultBlogService implements BlogService { 
private BlogDao blogDao; 


public void setBlogDao(BlogDao blogDao) { 
this.blogDao = blogDao; 
} 


// this is (unsurprisingly) the initialization callback method 
public void init() { 
if (this.blogDao == null) { 
throw new IllegalStateException("The [blogDao] property must be set."); 
} 


<beans default-init-method="init"> 


<bean id="blogService" class="com.foo.DefaultBlogService"> 
<property name="blogDao" ref="blogDao" /> 
</bean> 


</beans> 


<beans/> 标签 上 面 的 default-init-method 属性 会 让 Spring loC 容 器 识别 叫做 init 的 方法 来 
作为 Bean 的 初始 化 回调 方法 。 当 Bean 创 建 和 装载 之 后 ， 如 果 Bean 有 这 么 一 个 方法 的 话 ， 
Spring 容 器 就 会 在 合适 的 时 候 调 用 。 


类 似 的 ， 开 发 者 也 可 以 配置 默认 销毁 回调 函数 ， 基 于 XML 的 配置 就 在 <beans/> 标签 上 面 使 
用 default-destroy-method 属性 。 


当 存 在 一 些 Bean 的 类 有 了 一 些 回调 函数 ， 而 和 配置 的 默认 回调 函数 不 同 的 时 候 ， 开 发 者 可 以 
通过 特 指 的 方式 来 夫 盖 掉 默 认 的 回调 函数 。 以 XML 为 例 ， 就 是 通过 使 用 <bean> 标签 的 init- 
method 和 destroy-method KE BE <beans/> 中 的 配置 。 


Spring 容器 会 做 出 如 下 保证 ，Bean 会 在 装载 了 所 有 的 依赖 以 后 ， 立 刻 就 开始 执行 初始 化 回 

调 。 这 样 的 话 ， 初 始 化 回调 只 会 在 直接 的 Bean 引 用 装载 好 后 调用 ， 而 AOP 拦 截 器 还 没有 应 用 

到 Bean 上 。 首 先 目 标 Bean 会 完全 初始 化 好 ， 然 后 ，AOP 代 理 以 及 其 拦截 链 才 能 应 用 。 如 果 目 
标 Bean 以 及 代理 是 分 开 定 义 的 ， 那 么 开发 者 的 代码 甚至 可 以 跳 过 AOP 而 直接 和 引用 的 Bean 交 
互 。 因 此 ， 在 初始 化 方法 中 应 用 拦截 器 会 前 后 了 矛盾， 因为 这 样 做 耦合 了 目标 Bean 的 生命 周期 

和 代理 /拦截 器 ， 还 会 因为 同 Bean 直 接 交互 而 产生 奇怪 的 现象 。 


Combining lifecycle mechanisms 


在 Spring 2.5 之 后 ， 开 发 者 有 三 种 选择 来 控制 Bean 的 生命 周期 行为 : 


© InitializingBean 和 DisposableBean 回调 接口 
e 自 定义 的 init() 以 及 destroy 方法 


° 使 用 @PostConstruct VAR @PreDestroy 注解 
开发 者 也 可 以 在 Bean 上 联合 这 些 机 制 一 起 使 用 


如 果 Bean 配 置 了 多 个 生命 周期 机 制 ， 而 且 每 个 机 制 配 置 了 不 同 的 方法 名 字 ， 和 那么 每 个 配 
置 的 方法 会 按照 后 面 描述 的 顺序 PIE tea 2 ie o R 
回调 为 init() ， 在 不 止 一 个 生命 周期 机 制 配置 为 这 个 方法 的 情况 下 ， 这 个 方法 只 会 执行 


一 次 。 
如 果 一 个 Bean 配 置 了 多 个 生命 周期 机 制 ， 并 且 含有 不 同 的 方法 名 ， 执 行 的 顺序 如 下 : 


© 包含 @postconstruct 注解 的 方法 
。 在 InitializingBean 接口 中 的 afterPropertiesSet () 方法 
e 自 定 义 的 init() 方法 


销毁 方法 的 执行 顺序 和 初始 化 的 执行 顺序 相同 : 


e 包含 @PreDestroy 注解 的 方法 
e 在 DisposableBean 接口 中 的 destroy() 方法 
e 自 定 义 的 destroy() 方法 


Startup and shutdown callbacks 


Lifecycle 接口 中 为 任何 有 自己 生命 周期 需求 的 对 象 定 义 了 一 些 基 本 的 方法 【比如 启动 和 停 
止 一 些 后 台 进 程 ) : 


public interface Lifecycle { 
void start(); 
void stop(); 


boolean isRunning(); 


任何 Spring 管理 的 对 象 都 可 实现 上 面 的 接口 。 那 么 当 ppplicationcontext 本 身 收 到 了 启动 或 者 
停止 的 信号 时 比如 运行 时 的 停止 或 者 重启 等 场景 m °? ApplicationContext 会 通 通知 到 所 有 上 下 
文中 包含 的 生命 周期 对 象 ， applicationcontext 通过 将 代理 到 Lifecycleprocessor 来 串联 上 
下 文中 的 Lifecycle 的 实现 对 象 。 


public interface LifecycleProcessor extends Lifecycle { 
void onRefresh(); 


void onClose(); 


从 上 面 代码 我 们 可 以 发 现 Lifecycleprocessor Æ Lifecycle 接口 的 扩 
展 。 LifecycleProcessor 增加 了 另外 的 两 个 方法 来 针对 上 下 文 的 刷新 和 关闭 做 出 反应 。 


常 规 的 org.springframework.context.Lifecycle 接口 只 是 为 明确 的 开始 /停止 通知 提供 一 

契约 ， 而 并 不 表示 在 上 下 文 刷 新 会 自动 开始 。 考 虑 实 

IL org.springframework.context.SmartLifecycle 接口 则 可 以 取代 在 某 个 Bean 的 自动 启动 
旦 (包括 启动 阶段 )。 同 时 ， 停 止 通知 并 不 能 保证 在 销毁 之 前 出 现 : 在 正常 的 关闭 情 

况 下 ， 所 有 的 Lifecycle Bean 都 会 在 销毁 回调 准备 好 之 前 收 到 停止 通知 ， 然 而 ， 在 上 下 

文 存活 期 的 热 刷新 或 者 停止 刷新 尝试 的 时 候 ， 只 会 调用 销毁 方法 。 





启动 和 关闭 调用 是 很 重要 的 。 如 果 不 同 的 Bean 之 间 存 在 depends-on 的 关系 的 话 ， 被 依赖 的 一 
方 需要 更 早 的 启动 ， 而 且 关 闭 的 更 早 。 然 而 ， 有 的 时 候 直接 的 依赖 是 未 知 的 ， 而 开发 者 仅仅 

知道 哪 一 种 类 型 需要 更 早 进行 初始 化 。 在 这 种 情况 下 ， SmartLifecycle 接口 定义 了 另 一 种 选 

项 ， 就 是 其 父 接口 phased 中 的 getPhase() 方法 。 


public interface Phased { 


int getPhase(); 


public interface SmartLifecycle extends Lifecycle, Phased { 
boolean isAutoStartup(); 


void stop(Runnable callback); 


当 启 动 时 ， 拥 有 最 低 的 phased 的 对 象 优先 启动 ， 而 当 关 闭 时 ， 是 相反 的 顺序 。 因 此 ， 如 果 一 
个 对 象 实现 了 smartLifecycle 然后 令 其 getPhase() 方法 返回 了 Integer.MIN_VALUE 的 话 ， 就 
会 让 该 对 象 最早 语 动 ， 而 最 晚 销 毁 。 显 然 ， 如 果 getPhase() 方法 返回 了 Integer .MAX_VALUE 就 
说 明了 该 对 象 会 最 晚 启 动 ， 而 最 早 销毁 。 当 考虑 到 使 用 phased 的 值得 时 候 ， 也 同时 需要 了 解 

常 没有 实现 smartLifecycle 的 Lifecycle 对 象 的 默认 值 ， 这 个 值 为 0。 因 此 ， 任 何 负 值 将 标 
明 对 象 会 在 标准 组 件 局 动 之 前 启动 ， 在 标准 组 件 销毁 以 后 再 进行 销毁 。 


SmartLifecycle 接口 也 定义 了 一 个 stop 的 回调 函数 。 任 何 实现 了 smartlifecycle 接口 的 函 
数 都 必须 在 关闭 流程 完成 之 后 调用 回调 中 的 run() 方法 。 这 样 做 可 以 使 能 异步 关闭 。 

而 LifecycleProcessor 的 默认 实现 DefaultLifecycleprocessor 会 等 到 配置 的 超时 时 间 之 后 再 
调用 回调 。 黑 认 的 每 一 阶段 的 超时 时 间 为 30 秒 。 开 发 者 可 以 通过 定义 一 个 叫 

做 lifecycleProcessor open E 默认 的 生命 周期 处 理 器 。 如 果 开 发 者 需要 配置 超时 时 

间 ， 可 以 通过 如 下 代码 进行 配置 : 


<bean id="lifecycleProcessor" class="org.springframework.context.support.DefaultLifecy 
cleProcessor"> 

<!-- timeout value in milliseconds --> 

<property name="timeoutPerShutdownPhase" value="10000"/> 
</bean> 


前 文 提 到 的 ， Lifecycleprocessor 接口 定义 了 回调 方法 来 刷新 和 关闭 上 下 文 。 关 闭 的 话 ， 如 
果 stop() 方法 已 经 明确 调用 了 ， 那 么 就 会 驱动 关闭 的 流程 ， 但 是 如 果 是 上 下 文正 在 关闭 就 不 
会 发 生 这 种 情况 。 而 刷新 的 回调 会 使 用 smartLifecycle 的 另 一 个 特性 。 当 上 下 文 刷新 完毕 
(所 有 的 对 象 已 经 实例 化 并 初始 化 ) ， 那 么 就 会 调用 回调 ， 默 认 的 生命 周期 处 理 器 会 检查 每 
> SmartLifecycle 对 象 的 isAutoStartup() 这 返回 的 Bool 值 。 to RAB uw? 对 象 将 会 自动 启动 而 
不 是 等 待 明确 的 上 下 文 调用 ， 或 者 调用 自己 的 start() 方法 (不 同 于 上 下 文书 新， 标准 的 上 下 
文 实现 是 不 会 自动 启动 的 )。 phased 的 值 以 及 depends-on 关系 会 决定 对 象 尼 动 和 销毁 的 顺 
序 。 


Shutting down the Spring loC container gracefully in non- 
web applications 


这 一 部 分 只 是 针对 于 非 Web 的 应 用 。Spring 的 基于 web 的 applicationcontext 实现 已 经 有 
代码 在 web 应 用 关闭 的 时 候 能 够 自动 的 的 关闭 Spring loC 容 器 。 


如 果 开 发 者 在 非 web 应 用 环境 使 用 Spring loC 容 器 的 话 ， 比 如 ， 在 桌面 客户 端的 环境 下 ， 开 发 
者 需要 在 JVM 上 注册 一 个 关闭 的 钩子 ， 来 确保 在 关闭 Spring loC 容 器 的 时 候 能 够 调用 相关 的 销 
毁 方法 来 释放 掉 引 用 的 资源 。 当 然 ， 开 发 者 也 必须 要 正确 的 配置 和 实现 那些 销毁 回调 。 


开发 者 可 以 在 ConfigurableApplicationContext 接口 调用 registerShutdownHook( ) 来 注册 销毁 
的 钓 子 : 


import org.springframework.context.ConfigurableApplicationContext; 
import org.springframework.context.support.ClassPathxXmlApplicationContext; 


public final class Boot { 
public static void main(final String[] args) throws Exception { 


ConfigurableApplicationContext ctx = new ClassPathxXmlApplicationContext ( 
new String []{"beans.xml"}); 


// add a shutdown hook for the above context... 
ctx.registerShutdownHook(); 


// app runs here... 


// main method exits, hook is called prior to the app shutting down... 


ApplicationContextAware and BeanNameAware 


4 ApplicationContext 在 创建 实现 了 org.springframework.context .ApplicationContextAware 接 
口 的 对 象 时 ， 该 对 象 的 实例 会 包含 一 个 到 applicationcontext 的 引用 。 


public interface ApplicationContextAware { 


void setApplicationContext(ApplicationContext applicationContext) throws BeansExce 
ption; 


这 样 Bean 就 能 够 通过 编程 的 方式 操作 和 创建 ApplicationContext 了 。 通 

过 applicationContext 接口 ， 或 者 通过 将 引用 转换 成 已 知 的 接口 的 子 类 ， 比 

如 ConfigurableApplicationContext 就 能 够 提供 一 些 额 外 的 功能 其 中 的 一 个 用 法 就 是 可 以 通 
过 编程 的 方式 来 获取 其 他 的 Bean 。 有 的 时 候 这 个 能 力 很 有 用 。 当 然 ，Spring 团 队 推 荐 最 好 不 
要 这 样 做 ， 因 为 这 样 会 耦合 代码 到 Spring 上 ， 同 时 也 没有 遵循 loC 的 风 

格 。 ApplicationContext 的 其 它 的 方法 可 以 提供 一 些 到 诸如 资源 的 访问 ， 发 布 应 用 事件 z 或 
者 进入 MessageSource 之 类 的 功能 。 这 些 信 息 在 后 续 的 针对 ApplicationContext 的 描述 中 会 讲 
到 。 


在 Spring 2.5 版 本 中 ， 自 动 装 载 也 是 获得 Applicationcontext 的 一 种 方式 。 传 统 的 构造 函数 和 
通过 类 型 的 装载 方式 (前文 依赖 中 有 相关 描述 ) 可 以 通过 构造 函数 或 者 是 setter 方 法 的 方式 注 
入 ， 开 发 者 也 可 以 通过 注解 注入 的 方式 。 


4 applicationContext 创建 了 一 个 实现 
E org. e beans. factory.BeanNameAware 接口 的 类 ， 那 么 这 个 类 就 可 以 针对 其 名 
public interface BeanNameAware { 


void setBeanName(string name) throws BeansException; 


这 个 回调 的 调用 处 于 属性 配置 完 以 后 ， 但 是 初始 化 回调 之 前 。 比 
如 InitializingBean 的 afterPropertiesSet() 方法 以 及 自 定 义 的 初始 化 方法 等 。 
Other Aware interfaces 


除了 上 面 描述 的 两 种 Aware 接 口 ，Spring 还 提供 了 一 系列 的 aware A haan ， 
这 些 Bean 需 要 一 些 具体 的 基础 设施 信息 。 最 重要 的 一 些 aware 接口 都 在 下 面 表 中 进行 了 描 


名 字 注入 的 依赖 


ApplicationContextAware 声明 的 ApplicationContext 
ApplicationEventPlulisherAware ApplicationContext 中 的 事件 发 布 器 
BeanClassLoaderAware 加 载 Bean 使 用 的 类 加 载 器 
BeanFactoryAware 声明 的 BeanFactory 

BeanNameAware Bean 的 名 字 


容器 运行 的 资源 适配器 ,通常 仅 在 
Be 容器 运行 的 资源 适 酉 BootstrapContext ° 24 A 仅 在 


JCA 环 境 下 有 效 
LoadTimeweaverAware 加 载 期 间 处 理 类 定义 的 weaver 
MessageSourceAware 解析 消息 的 配置 策略 
NotificationPublisherAware Spring JMX 通 知 发 布 器 


容器 当 前 运行 的 PortletConfig ， 仅 在 web 下 的 


PortletConfigAware s 
Spring ApplicationContext 中 可 见 


容器 当 前 运行 的 PortletContext ， 4a fe web T 89 


PortletContextAware f 
Spring ApplicationContext 中 可 见 


ResourceLoaderAware 配置 的 资源 加 载 跨 


容器 当前 运行 的 ServletConfig ， 仅 在 web 下 的 


ServletConfigAware i 
Spring Applicationcontext 中 可 见 


容器 当 前 运行 的 ServletContext ° 仅 在 web 下 的 


ServletContextAware ; 
Spring ApplicationContext Ge 


再 次 的 声明 ， 上 面 这 些 接口 的 使 用 是 违反 loC 原 则 的 ， 除 非 必 要 ， 最 好 不 要 使 用 。 


Bean definition inheritance 


bean 的 定义 可 以 包含 很 多 配置 信息 ， 包 括 构 造 方法 参数 ， 属 性 值 和 容器 特定 的 信息 ， 如 初始 
化 方法 ， 静 态 工厂 方法 名 称 等 。 子 bean 定 义 从 继承 父 bean 定 义 的 配置 元 数据 。 子 bean 可 以 履 
盖 或 者 添加 一 些 它 所 需要 的 值 。 使 用 父子 bean 定 义 可 以 节省 很 多 配置 输入 。 实 际 上 ， 这 是 一 
种 模板 形式 。 


如 果 你 编程 式 地 使 用 Applicationcontext 接口 ， 子 bean 的 定义 可 以 通 

过 childBeanpefinition 类 来 表示 。 很 多 用 户 不 使 用 这 个 级 别 的 方法 ， 而 是 在 类 似 

于 classpathxmlApplicationCcontext 中 声明 式 地 配置 bean 的 定义 。 当 你 使 用 基于 XML 配置 时 ， 
你 可 以 在 子 bean 中 用 parent 属性 ， 该 属性 的 值 用 来 标识 父 bean。 


<bean id="inheritedTestBean" abstract="true" 
class="org.springframework.beans.TestBean"> 
<property name="name" value="parent"/> 
<property name="age" value="1"/> 
</bean> 


<bean id="inheritswithDifferentClass" 
class="org.springframework.beans.DerivedTestBean" 
parent="inheritedTestBean" init-method="initialize"> 
<property name="name" value="override"/> 
<!-- the age property value of 1 will be inherited from parent --> 
</bean> 


子 bean 如 果 没 有 指定 class， 它 将 使 用 父 bpean 定 义 的 class， 但 也 可 以 进行 重 载 。 在 后 一 种 情 
况 中 ， 子 bean 必 须 与 父 bpean 兼 容 ， 也 就 是 说 ， 它 必须 接受 父 bpean 的 属性 值 。 


子 bean 定 义 从 父 类 继承 作用 域 ， 构 造 器 参数 ， 属 性 值 ， 和 可 以 重 写 的 方法 ， 除 此 之 外 ， 还 可 
以 增加 新 的 值 。 你 指定 的 任何 作用 域 ， 初 始 化 方法 ， 销 毁 方 法 ， 和 /或 者 静态 工厂 方法 设置 ， 
都 会 覆盖 相应 的 父 bpean 设 置 。 

其 余 的 设置 总 是 取 自 子 bean 定 义 : depends on, autowire mode, dependency check, 
singleton, scope, lazy init ° 


上 面 的 例子 ， 通 过 使 用 abstract 属性 明确 地 表明 这 个 父 bean 定 义 是 抽象 的 。 如 果 ， 父 bean 定 
义 没有 明确 地 指出 所 属 的 类 > 那么 标记 父 bean 定 义 为 abstract 是 必须 的 ， 如 下 : 


<bean id="inheritedTestBeanWithoutClass" abstract="true"> 
<property name="name" value="parent"/> 
<property name="age" value="1"/> 

</bean> 


<bean id="inheritswithClass" class="org.springframework.beans.DerivedTestBean" 
parent="inheritedTestBeanwithoutClass" init-method="initialize"> 
<property name="name" value="override"/> 


<!-- age will inherit the value of 1 from the parent bean definition--> 
</bean> 


这 个 父 bean 不 能 自主 实例 化 ， 因 为 它 是 不 完整 的 ， 同 时 它 也 明确 地 被 标注 为 abstract 3 像 这 
样 ， 一 个 bean 定 义 为 abstract 的 ， 它 只 能 作为 一 个 纯粹 的 bean 模 板 ， 为 子 bean 定 义 ， 充 当 
父 bean 定 义 。 党 试 独立 地 使 用 这 样 一 个 abstract 的 父 bean， 把 他 作为 另 一 个 bean 的 引用 ， 
或 者 根据 这 个 父 bean 的 id 显 式 调用 getBean() 方法 ， 将 会 返回 一 个 错误 。 类 似 地 ， 容 器 内 部 
的 preInstantiateSingletons() 方法 ， 也 忽略 定义 为 抽象 的 bean 定 义 。 

ApplicationContext 默认 会 预 实例 化 所 有 单 例 bean。 因 此 ， 如 果 你 打算 把 一 个 ( 父 )bean 


定义 仅仅 作为 模板 来 使 用 ， 同 时 给 它 指定 了 class 属性， 你 必须 确保 设置 abstract 属性 
为 true, 否 则 ， 应 用 程序 上 下 文 ， 会 (尝试 ) 预 实例 化 这 个 abstract bean ° 


6.8 Container Extension Points 


通常 ， 应 用 程序 开发 者 ， 不 需要 继承 A SSC ene 的 实现 类 。 相 反 ，Spring loC 容 器 二 
以 通过 插入 特殊 的 集成 接口 的 实现 进行 拓展 。 新 的 一 节 中 ， 描 述 了 这 些 集成 接口 。 


6.8.1 Customizing beans using a BeanPostProcessor 


BeanPostProcessor 定义 了 回调 方法 ， 通 过 实现 这 个 回调 方法 ， 你 可 以 提供 你 自己 的 (或 者 重 写 
容器 默认 的 ) 实 例 化 逻辑 ， 依 赖 分 析 远 辑 等 等 。 想 在 Spring 容器 完成 实例 化 ， 配 置 ， 和 
初始 化 bean 之 后 ， 实 例 化 一 些 自 定义 的 逻辑 ， 你 可 以 插入 一 个 或 多 个 BeanPostProcessor 的 实 
现 。 


你 可 以 配置 多 个 BeanPostProcessor 实例 ， 你 可 以 通过 设置 order 属性 来 控制 这 些 
BeanPostProcessors 执 行 的 顺序 。 你 可 以 设置 这 个 属性 仅 当 BeanpostProcessor 实现 

了 ordered 接口 。 如 果 你 编写 自己 的 BeanPostProcessor 你 也 应 该 考虑 实现 ordered 接口 。 更 
多 细节 ， 请 查看 BeanPostProcessor 和 Ordered 接口 的 javadocs ， 也 可 以 看 看 下 面 的 要 点 
programmatic registration of BeanPostProcessors 。 


BeanPostProcessors 作用 在 一 个 bean( 或 者 对 象 ) 的 实例 上 ;也 就 是 说 ，Spring loC 实 例 化 
一 个 bean 实 例 之 后 ，BeanPostProcessors， 才 开始 进行 处 理 。 BeanPostProcessors 作 
用 范围 是 每 一 个 容器 。 这 仅仅 和 你 正在 使 用 容器 有 关 。 如 果 你 在 一 个 容器 中 定义 了 一 


个 BeanPostProcessor ， 它 将 仅仅 后 置 处 理 那 个 容器 中 的 beans。 换 言 之 ， 一 个 容器 中 的 
beans 不 会 被 另 一 个 容器 中 的 BeanPostProcessor 处 理 ， 即 使 这 ， 具 有 相同 的 父 
Ro ATF Seti SL (| 4e > blueprint 定义 的 bean)， 需要 使 


用 BeanFactoryPostProcessor ， 就 像 在 Section 5.8.2, ‘ ae lah ae 


metadata with a BeanFactoryPostProcessor’” ¥ 4% it iy AB A¥ ° 


org.springframework.beans.factory.config.BeanPostProcessor 接口 ， 由 两 个 回调 方法 组 成 
当 这 样 的 一 个 类 注册 为 容器 的 一 个 后 置 处 理 器 ， 由 于 每 一 个 bean 实 例 都 是 由 容器 创建 的 ， 这 
个 后 置 处 理 器 会 在 容器 的 初始 化 方法 (比如 |nitializingBean 的 afterPropertiesSet() 和 任何 生命 的 
初始 化 方法 ) 被 调用 之 前 和 任何 bean 实 例 化 回调 之 后 从 容器 得 到 一 个 回调 方法 。 后 置 处 理 器 
可 以 对 bean 和 采取 任何 措施 ， 包 括 完 全 忽略 回调 。 一 个 bean 后 置 处 理 器 ， 通 eee 
或 者 使 用 代理 包装 一 个 bean。 EO AOP 基 础 设施 类 ， 为 了 提供 包装 式 的 代理 逻辑 ， 被 
实现 为 bean 后 置 处 理 器 

Applicationcontext 会 自动 地 检测 所 有 定义 在 配置 元 文件 中 ， 并 实现 了 BeanpostProcessor 接 
口 的 bean。 该 Applicationcontext 注册 这 些 beans 作 为 后 置 处 理 器 ， 使 他 们 可 以 在 bean 创 建 
完成 之 后 被 调用 。bean 后 置 处 理 器 可 以 像 其 他 bean 一 样 部 署 到 容器 中 。 


oe Bip kek & 
容器 扩展 点 


注意 ， 当 在 一 个 配置 类 上 ， 使 用 @Bean 工 厂 方法 声明 一 个 BeanPostProcessor ， 工 厂 方法 返回 
的 类 型 应 该 是 实现 类 自身 ， 或 至 少 也 要 是 
org.springframework.beans.factory.config.BeanPostProcessor 接口 ， 要 清楚 地 表明 这 个 bean 
的 后 置 处 理 器 本 质 特点 。 和 否则 ， 在 它 完 全 创建 之 前 ， Applicationcontext 将 不 能 通过 类 型 自 
动 探测 它 。 由 于 一 个 BeanPostProcessor， 早 期 就 需要 被 实例 化 ， 以 适应 上 下 文中 其 他 bean 
的 实例 化 ， 因 此 这 个 早期 的 类 型 检查 是 至 关 重 要 的 。 


虽然 推荐 使 用 Applicationcontext 的 自动 检测 来 注册 BeanPostProcessor ， 但 是 也 可 以 编 
程式 地 使 用 ConfigurableBeanFactory 的 addBeanPostProcessor 方法 来 注册 $ 这 对 于 在 注 
册 之 前 需要 对 条 件 逻 辑 进 行 评估 ， 或 者 是 在 继承 层次 的 上 下 文 之 问 复制 bean 后 置 处 理 器 
是 有 很 有 用 的 。 但 是 请 注意 ， 编 程 地 添加 的 BeanPostProcessors 不 需要 考虑 ordered 接 
口 。 也 就 是 注册 的 顺序 决定 了 执行 的 顺序 。 也 要 注意 ， 编 程式 注册 

的 BeanPostProcessors ， 总 是 预先 被 处 理 ---- 早 于 通过 自动 检测 方式 注册 的 ， 同 时 忽略 任 
何 明确 的 排序 。 


实现 了 BeanPostProcessor 接口 的 类 是 特殊 的 ,会 被 容器 特殊 处 理 。 所 

有 BeanPostProcessors 和 他 们 直接 引用 的 beans 都 会 在 容器 启动 的 时 候 被 实例 化 , 作 

为 ApplicationContext 特殊 启 动 阶段 的 一 部 分 S 接着 所 有 的 BeanPostProcessors 以 一 
个 有 序 的 方式 进行 注册 ， 并 应 用 于 容器 中 的 一 切 bean。 因 为 AOP 自 动 代理 本 身 被 实现 
为 BeanPostProcessor ， 这 个 BeanPostProcessors 和 它 直接 应 用 的 beans 都 没有 资格 进行 
自动 代理 ， 这 样 就 没有 切面 编织 到 他 们 里 面 。 对 于 所 有 这 样 的 bean， 你 会 看 到 一 个 info 
日 志 : "Bean foo is not eligible for getting processed by all BeanPostProcessor 
interfaces (for example: not eligible for auto-proxying)" ° 

注意 ， 如 果 你 有 beans 使 用 自动 装配 或 者 @Resource 装配 到 了 你 

的 BeanPostProcessor 中 ， 当 根据 依赖 搜索 匹配 类 型 时 ，Spring 也 许 会 访问 意外 类 型 的 
bean; 因此 ， 使 它们 没有 资格 进行 自动 代理 ， 或 者 其 他 类 型 的 bean 后 置 处 理 。 例 如 ， 你 
使 用 @Resource 注解 一 个 依赖 其 中 字段 或 者 set 方 法 名 不 是 和 bean 声 明 的 名 字 直 接 对 
应 ， 同 时 没有 name 属 性 被 使 用 ， 然 后 ，Spring 将 会 根据 类 型 ， 访 问 其 他 beans 进 行 匹 
配 。 


下 面 的 示例 显示 了 如 何在 Applicationcontext 中 编写 ， 注 册 ， 使 用 BeanPostProcessor ° 


Example: Hello World, BeanPostProcessor-style 


a 


第 一 个 示例 演示 了 基础 的 使 用 。 示 例 中 演示 了 一 个 自 定义 的 BeanPostProcessor 实现 ， 在 容器 
创建 bean 后 调用 了 每 个 bean 的 tostring() 方法 ， 并 把 结果 输出 到 控制 台 上 。 


以 下 是 自 定义 BeanPostProcessor 实现 类 的 定义 : 
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package scripting; 


import org.springframework.beans.factory.config.BeanPostProcessor; 
import org.springframework.beans.BeansException; 


public class InstantiationTracingBeanPostProcessor implements BeanPostProcessor { 


// simply return the instantiated bean as-is 
public Object postProcessBeforeInitialization(Object bean, 
String beanName) throws BeansException { 
return bean; // we could potentially return any object reference here... 


public Object postProcessAfterInitialization(Object bean, 
String beanName) throws BeansException { 
System.out.printin("Bean ''" + beanName + "'' created : " + bean.toString()); 
return bean; 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlins: lang="http://www.springframework.org/schema/lang" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd 
http://www. springframework.org/schema/lang 
http://www. springframework.org/schema/lang/spring-lang.xsd"> 


<lang:groovy id="messenger" 
script-source="classpath:org/springframework/scripting/groovy/Messenger .gr 
oovy"> 
<lang:property name="message" value="Fiona Apple Is Just So Dreamy."/> 
</lang:groovy> 


<li = 

when the above bean (messenger) is instantiated, this custom 
BeanPostProcessor implementation will output the fact to the system console 
--> 


<bean class="scripting.InstantiationTracingBeanPostProcessor"/> 


</beans> 


注意 InstantiationTracingBeanPostProcessor 是 简 单 地 定义 2 它 甚至 没有 名 字 > AA 它 能 像 其 
它 bean 一 样 被 依赖 注入 。 (上 面 示例 中 也 定义 了 一 个 使 用 Groovy 脚 本 支持 的 bean。Spring 动 
态 语言 支持 详 见 Chapter 34, Dynamic language support) 


下 面 简 单 的 Java 应 用 执行 了 前 面 代码 和 配置 : 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathxXmlApplicationContext; 
import org.springframework.scripting.Messenger; 


public final class Boot { 


public static void main(final String[] args) throws Exception { 
ApplicationContext ctx = new ClassPathXmlApplicationContext("scripting/beans.x 
ml"); 
Messenger messenger = (Messenger) ctx.getBean('"messenger"); 
System.out.println(messenger ); 


上 面 应 用 运行 输出 结果 如 下 : Bean 'messenger' created : 
org.springframework.scripting.groovy.GroovyMessenger@272961 
org.springframework.scripting.groovy.GroovyMessenger@272961 


Example: The RequiredAnnotationBeanPostProcessor 


自 定 义 BeanPostProcessor 实现 与 回调 接口 或 注解 配合 使 用 ， 是 一 种 常见 的 扩展 Spring loC 容 
器 的 手段 0 一 个 例子 就 是 RequiredAnnotationBeanPostProcessor -这 是 一 

个 BeanPostProcessor 实现 ， 确 保 用 (任意 ) 注解 标记 的 那些 JavaBean 属 性 确实 被 注入 一 个 
值 。 


6.8.2 Customizing configuration metadata with a 
BeanFactoryPostProcessor 


下 一 个 我 们 要 看 的 扩展 点 

是 org.springframework.beans.factory.config.BeanFactoryPostProcessor ° 这 个 接口 的 语义 

F BeanPostProcessor 类 似 ， 但 有 一 个 主要 的 不 同 点 : BeanFactoryPostProcessor 操作 bean 的 
置 元 数据 ; 也 就 是 说 ， Spring 的 IoC 容 器 器 允许 BeanFactoryPostProcessor 来 读 取 配 置 元 数据 

= 器 实例 化 任何 bean( 除 了 BeanFactoryPostProcessor ) 之 前 可 以 修改 它 


你 可 以 配置 多 个 BeanFactoryPostProcessor 实例 > 你 可 以 通过 设置 order 属性 来 控制 这 
此 BeanFactoryPostProcessor 执行 的 顺序 。 你 可 以 设置 这 个 属性 仅 

4 BeanFactoryPostProcessor 实现 了 ordered 接口 © 如 果 你 编写 自 已 

的 BeanFactoryPostProcessor 你 也 应 该 考虑 实现 ordered 接口 。 更 多 细节 ， 请 查 

看 BeanPostProcessor 和 Ordered 接口 的 javadocs 


to RAR RE POA EH beank] (也 就 是 说 ， 从 配置 元 数据 中 创建 的 对 象 ) ， 那 么 你 需要 
使 用 BeanPostProcessor (在 上 面 6.8.1 节 ，“Customizing beans using a 
BeanPostProcessor” 中 描述 ) 来 代替 。 在 BeanFactoryPostProcessor (比如 使 用 
BeanFactory.getBean()) 中 来 使 用 这 些 bean 的 实例 虽然 在 技术 上 有 是 可 行 的 ， 但 这 么 来 做 
会 引起 bean 过 旱 实 例 化 ， 违 反 标 准 的 容器 生命 周期 。 这 也 会 引发 一 些 副作用 ， 比 如 绕 过 
bean 的 后 置 处 理 。 


BeanFactoryPostProcessors 作用 范围 是 每 一 个 容器 。 这 仅仅 和 你 正在 使 用 容器 有 关 。 如 





果 你 在 一 个 容器 中 定义 了 一 个 BeanFactoryPostProcessor ， 它 将 仅仅 后 置 处 理 那个 容器 
中 的 beans。 换 言 之 ， 一 个 容器 中 的 beans 不 会 被 另 一 个 容器 中 


的 BeanFactoryPostProcessor 处 理 ， 即 使 这 两 个 容器 ， 具 有 相同 的 父 类 。 


当 在 applicationcontext 中 声明 时 ，bean 工 厂 后 置 处 理 器 会 自动 被 执行 ， 这 就 可 以 对 定义 在 
容器 中 的 配置 元 数据 进行 修改 。Spring 包 含 了 一 些 预 定义 的 bean 工 厂 后 置 处 理 器 re 

如 PropertyOverrideConfigurer 和 PropertyPlaceholderConfigurer ° 自 定义 

的 BeanFactoryPostProcessor 也 可 以 用 来 ， 比 如 ， 注 册 自 定义 的 属性 编辑 器 


ApplicationContext 会 自动 检测 任意 部 署 其 中 ， 且 实现 了 BeanFactoryPostProcessor 接口 的 
bean。 在 适当 的 时 间 ， 它 用 这 些 bean 作 为 bean 工 厂 后 置 处 理 器 。 你 可 以 部 署 这 些 后 置 处 理 器 
bean 作 为 你 想 用 的 任意 其 它 的 bean。 


和 BeanPostProcessor 一 样 ， 通常 你 不 会 会 想 配置 和 来 进 行 延 迟 初 
始 化 。 如 果 没 有 其 它 bean 引 用 Bean(Factory)Postprocessor ， 那 么 后 置 处 理 器 就 不 会 被 初 
始 化 了 。 因 此 ， 标 记 它 为 延迟 初始 化 就 会 被 忽略 ， 即 便 你 在 <beans/> = 明 中 设 

置 default-lazy-init 属性 为 true ° ABA Bean(Factory)PostProcessor 也 会 正 常 被 初始 
化 。 


Example: the Class name substitution 
PropertyPlaceholderConfigurer 


从 使 用 了 标准 Java Properties 格式 的 bean 定 义 的 分 文件 中 ， 你 可 以 使 

用 propertyPlaceholderConfigurer 来 具体 化 属性 值 。 这 么 做 允许 部 署 应 用 程序 来 自 定义 指定 的 
环境 属性 ， 比 如 数据 库 的 连接 URL 和 密码 ， ene 容器 的 主 XML 定 义 文 件 或 其 它 文件 的 
复杂 性 和 风险 。 


考虑 一 人 个 基于 XML 的 配置 元 数据 代码 片段 ， 这 里 的 datasource 就 使 用 了 占 位 符 来 
定义 。 个 示例 展示 了 从 properties 文件 中 配置 属性 的 方法 。 在 运行 

时 ， PropertyPlaceholderconfigurer 就 会 用 于 元 数据 并 为 数据 源 替换 一 些 属 性 。 指 定 替 换 的 值 
作为 $fproperty-name} 形式 中 的 占 位 符 ， 这 里 应 用 了 Ant/log4j/JSP EL 的 风格 。 


<bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
<property name="locations" value="cClasspath:com/foo/jdbc.properties"/> 
</bean> 


<bean id="dataSource" destroy-method="close" 
class="org.apache.commons.dbcp.BasicDataSource"> 
<property name="driverClassName" value="${jdbc.driverClassName}"/> 
<property name="url" value="${jdbc.url}"/> 
<property name="username" value="${jdbc.username}"/> 
<property name="password" value="${jdbc.password}"/> 
</bean> 


mA EARRA Tiig Java Properties 格式 的 文件 : 


jdbc.driverClassName=org.hsqldb.jdbcDriver 
jdbc.url=jdbc:hsqldb:hsql://production:9002 
jdbc.username=sa 

jdbc.password=root 


此 ， 字 符 串 $jdbc.username} 在 运行 时 会 被 值 'Sa' 替 换 ， 对 于 其 它 占 位 符 来 说 也 是 相同 的 ， 
匹配 到 了 属性 文件 中 的 键 就 会 用 其 值 蔡 换 占 位 符 ° PropertyPlaceholderConfigurer 在 bean 定 
义 的 属性 中 检查 占 位 符 。 此 外 ， 对 占 位 符 可 以 自 定义 前 级 和 后 级 。 


使 用 Spring 2.5 引入 的 context 命名 空间 ， 也 可 以 使 用 专用 的 配置 元 素来 配置 属性 占 位 符 。 
在 location 属性 中 ， 可 以 提供 一 人 RB NS VAIL FY AND RR 9 


<context:property-placeholder location="classpath:com/foo/jdbc.properties"/> 


PropertyPlaceholderConfigurer 不 仅仅 查看 在 Properties 文件 中 指定 的 属性 。 默 认 情 况 下 ， 
如 果 它 不 能 在 指定 的 属性 文件 中 找到 属性 ， 它 也 会 检查 Java system 属性 。 你 可 以 通过 设 
置 systemPropertiesMode 属性 ， 使 用 下 面 整数 的 三 者 之 一 来 自 定 义 这 种 行为 : 


e never(0) : 从 不 检查 系统 属性 

。 fallback(1) : 如 果 没 有 在 指定 的 属性 文件 中 解析 到 属性 ， 那 么 就 检查 系统 属性 。 这 是 默认 
的 情况 。 

e override(2) : 在 检查 指定 的 属性 文件 之 前 ， 首 先 去 检查 系统 属性 。 这 就 允许 系统 属性 履 盖 
其 它 任 意 的 属性 资源 。 


查看 propertyPlaceholderconfigurer 的 JavaDoc 文 档 来 获取 更 多 信息 。 


你 可 以 使 用 propertyPlaceholderConfigurer 来 替换 类 名 ， 在 运行 时 ， 当 你 不 得 不 去 选择 
一 个 特定 的 实现 类 时 ， 这 是 很 有 用 的 。 比 如 : 


<bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
<property name="locations"> 
<value>classpath:com/foo/strategy.properties</value> 
</property> 
<property name="properties"> 
<value>custom.strategy.class=com.foo.DefaultStrategy</value> 
</property> 
</bean> 


<bean id="ServiceStrategy" class="${custom.strategy.class}"/> 


如 果 类 在 运行 时 不 能 解析 成 一 个 有 效 的 类 ， 那 么 在 即将 创建 时 ，bean 的 解析 就 失败 了 ， 这 
是 ApplicationContext 在 对 非 延 迟 初 始 化 bean 的 preInstantiateSingletons() 阶段 发 生 的 。 


Example: the PropertyOverrideConfigurer 


PropertyOverrideConfigurer ， 另 外 一 种 bean 工 厂 后 置 处 理 器 ， 类 似 

于 PropertyPlaceholderConfigurer ， 但 不 像 后 者 ， 对 于 所 有 bean 的 属性 ， 原 始 定义 可 以 有 默 
认 值 或 没有 值 。 如 果 一 个 Properties 上 履 盖 文件 没有 特定 bean 的 属性 配置 项 ， 那 么 就 会 使 用 默 
认 的 上 下 文 定义 。 


注意 ，bean 定 义 是 不 知道 被 覆盖 的 ， 所 以 从 XML 定义 文件 中 不 能 立即 明显 反应 履 盖 配置 被 使 
用 中 。 在 多 个 propertyoverrideconfigurer 实例 的 情况 下 ， 为 相同 bean 的 属性 定义 不 同 的 
值 ， 那 么 最 后 一 个 有 效 ， 源 于 它 的 履 盖 机 制 。 


属性 文件 配置 行 像 这 种 格式 : 
beanName. property=value 
例如 : 


dataSource.driverClassName=com.mysql.jdbc.Driver 
dataSource.url=jdbc:mysql:mydb 


这 个 示例 文件 可 以 用 于 包含 了 dataSource bean 的 容器 ， 它 有 driver 和 url 属 性 。 


复合 属性 名 也 是 支持 的 ， 除 了 最 终 的 属性 被 覆盖 ， 只 要 路 径 中 的 每 个 组 件 都 是 非 空 的 〈 假 设 
由 构造 方法 初始 化 ) 。 在 这 个 例子 中 ... 


foo.fred.bob.sammy=123 


foo bean 的 fred 属性 的 bob 属性 的 sammy 属性 的 值 设 置 为 标量 123 © 


指定 的 和 O 它们 不 会 被 转换 成 bean 的 引用 。 当 XML 中 的 bean 定 义 的 原 
始 值 指定 了 bean 引用 时 ， 这 个 约定 也 适用 。 


使 用 Spring 2.5 引入 的 context 命名 空间 ， 可 以 使 用 专用 的 配置 元 素来 配置 属性 禾 盖 


<context:property-override location="classpath:override.properties"/> 


6.8.3 Customizing instantiation logic with a FactoryBean 
实现 了 org.springframework.beans.factory.FactoryBean 接口 的 对 象 是 它们 自己 的 工厂 。 


FactoryBean 接口 就 是 Spring loC 容 器 实例 化 逻辑 的 可 插 拔 点 。 如 果 你 的 初始 化 代码 很 复杂 ， 
那么 相对 于 (潜在 地 ) 大 量 详细 的 XML 而 言 ， 最 好 是 使 用 Java 语言 来 表达 。 你 可 以 创建 自 
Gay FactoryBean ， 在 类 中 编写 复杂 的 初始 化 代码 ， 之 后 将 你 自 定义 的 FactoryBean 插入 到 容 
器 中 。 FactoryBean 接口 提供 下 面 三 个 方法 : 


e are getobject() : 返回 工厂 创建 对 象 的 实例 。 这 个 实例 可 能 被 共享 ， 那 就 是 看 这 个 
返回 的 是 单 例 还 是 原型 实例 了 。 
e boolean isSingleton() : 如 果 FactoryBean 返回 单 例 的 实例 ， 那 么 该 方法 返回 true ， 
否则 就 返回 false ° 
e class getObjectType() : 返回 由 getobject() 方法 返回 的 对 象 类 型 ， 或 者 事先 不 知道 类 
型 时 返回 null 。 


FactoryBean 的 概念 和 接口 被 用 于 Spring Framework 中 的 很 多 地 方 ; 随 Spring 发 行 ， 有 起 
过 50 个 FactoryBean 接口 的 实现 类 。 


5 4 HARRER RARA 实 的 FactoryBean 实例 ， 而 不 是 它 生 产 的 bean， 调 
ApplicationContext 的 getBean() 方法 时 在 bean 的 id 之 前 加 连 字符 (a) 。 所 以 对 于 一 个 给 
Æ id A myBean 的 FactoryBean ， 调 用 容器 的 getBean("myBean") 方法 返回 的 


a 


Æ FactoryBean 的 产品 ; 而 调用 getBean("&myBean") 方法 则 返回 FactoryBean 实例 本 身 。 


6.10 Classpath scanning and managed 
components 


本 章 中 的 大 多 数 示例 都 使 用 XML 配置 元 数据 在 Spring 的 容器 中 生产 每 一 个 BeanDefinition。 
之 前 的 章节 (6.9 节 ，“ 基 于 注解 的 容器 配置 ") 表述 了 如 何 通过 代码 级 的 注解 来 提供 大 量 的 配 
置信 息 。 尽 管 在 那些 示例 中 ， “基础 的 "bean 的 定义 都 是 在 XML 文件 中 来 明确 定义 的 ， 而 注解 
仅仅 进行 依赖 注入 。 本 节 来 说 明 另 外 一 种 通过 扫描 类 路 径 的 方式 来 隐 式 检测 候选 组 件 。 候 选 
组 件 是 匹配 过 滤 条 件 的 类 库 ， a tinh peas hays 
来 执行 bean 的 注册 了 ， 那 么 你 就 可 以 使 用 注解 (比如 @component ) > AspectJ 风格 的 表达 
式 ， 或 者 是 你 自 定义 的 过 滤 条 件 来 选择 哪些 类 有 在 容器 中 注册 bean e 


从 Spring 3.0 开始 ， 很 多 由 Spring JavaConfig 项 目 提供 的 特性 作为 了 Spring 
Framework 核心 的 一 部 分 。 这 就 允许 你 使 用 Java 而 不 是 传统 的 XML 文件 来 定义 bean 
了 。 看 一 看 6 @Configuration °’ @Bean °’ @Import 和 @DependsOn 注解 的 例 TRI 解 如 何 
使 用 它们 的 新 特性 


6.10.1 @Component and further stereotype annotations 


在 Spring 2.0 版 之 后 ， @Repository 注解 是 任意 满足 它 的 角色 或 典型 库 (比如 熟知 的 数据 访 
问 对 象 ，DAO ) 的 类 的 标记 。 这 个 标记 的 有 多 种 用 途 ， 其 中 之 一 就 是 在 Section 19.2.2, 
“Exception translation” 中 描述 的 异常 自动 转化 。 


Spring 2.5 引入 了 更 多 的 典型 注解 : @Component ， @Service 和 @Controller ° @Component 
是 对 受 Spring 管理 组 件 的 通用 注解 ° @Repository ’ @Service 和 @Controller 

是 @Component 的 特殊 用 途 ， 比 如 ， 分 别 对 应 了 持久 层 ， 服 务 层 和 表现 层 。 因 此 ， 你 可 以 使 
用 @Component 注解 你 的 组 件 类 ， 但 是 如 果 使 用 @Repository ? @Service 或 @Controller 注 
解 来 替代 的 话 ， 那 么 你 的 类 更 合适 由 工具 来 处 理 或 与 切面 进行 关联 。 比 如 ， 这 些 老 套 的 注解 
使 得 理想 化 的 目 标 称 为 切入 点 ° mE @Repository ? @Service 和 @Controller 也 可 以 在 将 来 
Spring Framework 的 发 布 中 携带 更 多 的 语义 。 因 此 ， 如 果 对 于 服务 层 ， 你 在 @component 

或 @Service 中 间 选 择 的 话 ， 那 么 @service 无 疑 是 更 好 的 选择 。 相 似 地 ， 正 如 上 面 提 到 的 ， 
在 持久 层 中 ， @Repository 已 经 支持 作为 自动 异常 转化 的 标记 。 


6.10.2 Meta-annotations 


Spring 提供 了 很 多 元 注解 。 元 注解 简单 的 说 就 是 能 被 应 用 到 另 一 个 注解 上 的 注解 。 


@Target(ElementType. TYPE) 

@Retention(RetentionPolicy.RUNTIME) 

@Documented 

@Component // Spring will see this and treat @Service in the same way as @Component 
public @interface Service { 


LL 5.5% 


元 注解 也 可 以 被 组 合 使 用 用 于 创建 组 合 注 解 。 例 如 Spring MVC#) @restController 注解 就 


是 @Controller 和 @ResponseBody ° 


另外 ， 组 合 注解 可 能 从 元 注解 中 任意 重新 声明 属性 来 允许 用 户 自 定义 。 这 个 会 特别 有 用 当 你 
只 想 暴 露 一 个 源 注解 的 子 集 。 例 如 ， 下 面 是 一 个 自 定义 的 @scope 注解 ， 将 作用 域名 称 硬 编码 
到 @session 注解 上 ， 但 依然 允许 自 定义 proxyMode ° 


@Target(ElementType. TYPE) 
@Retention(RetentionPolicy.RUNTIME) 
@Scope( "session" 

public @interface SessionScope { 


ScopedProxyMode proxyMode() default ScopedProxyMode.DEFAULT; 


@sessionScope 可 以 不 声明 proxyMode 就 使 用 ， 如 下 所 示 : 


@Service 

@SessionScope 

public class SessionScopedUserService implements UserService { 
Ue nc 


RA A proxyMode 重 载 一 个 值 ， 如 下 所 示 : 


@Service 
@SessionScope(proxyMode = ScopedProxyMode.TARGET_CLASS) 
public class SessionScopedService { 

Whe a xh 


~ 


更 多 详情 ， 请 参阅 37. spring Annotation Programming Model 


6.10.3 Automatically detecting classes and registering bean 
definitions 


Spring 可 以 自动 检测 国有 的 类 并 在 Applicationcontext 中 注册 对 应 的 BeanDefinition ° Hi 
如 ， 下 面 的 两 个 类 就 是 自动 检测 的 例子 : 


@Service 
public class SimpleMovieLister { 


private MovieFinder movieFinder; 


@Autowired 
public SimpleMovieLister(MovieFinder movieFinder) { 
this.movieFinder = movieFinder; 


} 

@Repository 

public class JpaMovieFinder implements MovieFinder { 
// implementation elided for clarity 


要 自 动 检测 这 些 类 并 注册 对 应 的 bean ， 你 需要 添加 @ComponentScan 到 你 的 @Configuration 类 


上 ， 其 中 的 pase-package 元 素 是 这 两 个 类 的 公共 父 类 包 。 (你 可 以 任意 选择 使 用 去 号 /分 号 / 空 
格 分 隔 的 列表 来 将 每 个 类 引入 到 父 包 。) 


@Configuration 
@ComponentScan(basePackages = "org.example") 
public class AppConfig { 


为 了 更 简洁 ， 上 面 的 示例 可 以 使 用 注解 的 value 属性 ， 也 就 


X ComponentScan("org.example") 


下 面 的 示例 使 用 XML 配置 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:context="http://www. springframework.org/schema/context" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans.xsd 
http://www. springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context.xsd"> 


<context:component-scan base-package="org.example"/> 


</beans> 


<context : component -Scan> 隐 式 地 开户 ke J <context:annotation-config> 功能 ， 当 使 用 


了 <context: component-scan> 时 通 常 没 必 要 再 包 包含 <context:annotation-config> ° 


对 类 路 径 包 的 扫描 需要 类 路 径 下 存在 对 应 的 目录 实体 。 当 你 使 用 Ant 来 构建 JAR BH > 
要 保证 你 没有 激活 JAR 目标 中 的 files-only 开关 。 同 时 ， 在 一 些 环境 中 基于 安全 策略 ， 
类 路 径 下 的 文件 不 会 被 暴露 出 来 ， 如 果 单 独 的 apps 在 JDK 1.7.0 45 和 更 高 的 版 本 《这 需 
要 "Trusted-Library 计划 在 你 的 manifests 中 ，see 
http://stackoverflow.com/questions/19394570/java-jre-7u45-breaks-classloader- 
getresources ) 


此 外 ， 当 你 使 用 component-scan 时 ， AutowiredAnnotationBeanPostProcessor 和 
CommonAnnotationBeanPostProcessor 二 者 是 隐 式 包 包 含 着 的 这 就 意味 着 两 个 组 件 被 自 动 检测 之 
后 就 装配 在 一 起 了 -而 不 需要 在 XML 中 提供 其 它 任何 bean 的 配置 元 数据 。 


你 可 以 将 annotation-config 属性 置 为 false 来 关 


4] AutowiredAnnotationBeanPostProcessor 和 CommonAnnotationBeanPostProcessor 注册 。 


6.10.4 Using filters to customize scanning 


默认 情 况 下 ， 使 用 @Component °’ @Repository * @Service ， @Controller 注解 或 使 用 了 进行 
自 定 义 的 @Component 注解 的 类 本 身 仅 仅 检 测 候 选 组 件 。 你 可 以 修改 并 扩展 这 种 行为 ， 仅 仅 应 
用 自 定 义 的 过 滤器 就 可 以 了 。 在 @componentscan 注解 中 添加 include-filter 或 exclude- 
filter 就 可 以 了 (或 者 作为 component-scan 元 素 的 include-filter 或 exclude-filter 子 元 
素 ) 。 每 个 过 滤器 元 素 需 要 type 和 expression 属性 。 下 面 的 表格 描述 了 过 滤 选 项 。 


ise 


过 滤器 类 型 表达 式 示 例 CE 


annotation (3È org.example.SomeAnnotation ”使 用 在 目标 组 件 的 类 级 别 上 


EBRU ) 

ara ee org.example.SomeClass 目标 组 件 分 配 去 (扩展 /实现 ) 的 类 (4 

aspectj org.example..*Service+ AspectJ 类 型 表达 式 来 匹配 目标 组 件 

WR) ELLs org.example.Default.* 正则 表达 式 来 匹配 目标 组 件 类 的 名 称 

ee A org.example.MyTypeFilter > Snub Rao 
接口 的 实现 类 


下 面 的 示例 代码 展示 了 XML 配置 忽略 所 有 @Repository 注解 并 使 用 “sub" 库 来 替代 。 


@Configuration 
@ComponentScan(basePackages = "org.example", 
includeFilters = @Filter(type = FilterType.REGEX, pattern = ".*Stub.*Repositor 
y"), 
excludeFilters = @Filter(Repository.class)) 
public class AppConfig { 


} 
一 样 的 可 以 使 用 XML 配置 : 
<beans> 
<context:component-scan base-package="org.example"> 
<context:include-filter type="regex" 
expression=".*Stub. *Repository"/> 
<context:exclude-filter type="annotation" 
expression="org.springframework.stereotype.Repository"/> 
</context : component -scan> 
</beans> 


你 可 以 使 用 注解 的 usedefaultFilters=false 或 <component-scan/> 元 素 中 的 use-default- 


filter="false" 属性 来 关闭 默认 的 过 滤 器 。 这 会 关闭 自动 检 


wt] @component ， @Repository ， @Service 或 @Controller 注解 的 类 。 


6.10.5 Defining bean metadata within components 


Spring 组 件 可 以 为 容器 提供 bean 定义 的 元 数据 。 你 可 以 在 @configuration 注解 的 类 中 使 
用 @Bean 注解 来 达成 这 一 目的 。 这 里 有 一 个 简单 的 示例 : 


@Component 
public class FactoryMethodComponent { 


@Bean 
@Qualifier("public") 
public TestBean publicInstance() { 
return new TestBean("publicInstance") ; 


public void doWork() { 
// Component method implementation omitted 


这 个 类 是 个 Spring 组 件 ， 它 的 dowork() 方法 中 包含 特定 应 用 代码 。 同 时 ， 它 也 提供 了 bean 
的 定义 并 且 由 工厂 方法 来 指向 publicInstance() 方法 。 @Bean 注解 定义 了 工厂 方法 和 其 它 
bean 定义 的 属性 ， 比 如 通过 @qualifier 注解 表示 的 限定 符 。 其 它 方法 级 的 注解 可 以 使 用 的 
是 @Scope ，@Lazy 和 自 定义 限定 符 注解 。 


除了 组 件 初始 化 的 角色 ， @Lazy 注解 也 可 以 跟着 @Autowired 或 @Inject 放置 到 注入 点 。 
在 这 种 上 下 文中 ， 它 将 生成 一 个 延迟 解析 的 代理 注入 。 


自动 装配 字段 和 方法 也 是 支持 的 ， 这 在 之 前 讨论 过 ， 而 且 还 有 对 自动 装配 @Bean 方法 的 支 
持 : 


@Component 
public class FactoryMethodComponent { 


private static int i; 


@Bean 
@Qualifier ("public") 
public TestBean publicInstance() { 
return new TestBean("publicInstance"); 


// use of a custom qualifier and autowiring of method parameters 


@Bean 
protected TestBean protectedInstance( 
@Qualifier("public") TestBean spouse, 
@Value("#{privateInstance.age}") String country) { 
TestBean tb = new TestBean("protectedInstance", 1); 
tb.setSpouse(spouse); 
tb.setCountry(country); 
return tb; 


@Bean 
@Scope(BeanDefinition.SCOPE_SINGLETON) 
private TestBean privateInstance() { 
return new TestBean("privateInstance", i++); 


@Bean 
@Scope(value = WebApplicationContext.SCOPE_SESSION, proxyMode = ScopedProxyMode.TA 
RGET_CLASS) 
public TestBean requestScopediInstance() { 
return new TestBean("requestScopedInstance", 3); 
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这 个 示例 为 另外 一 个 名 为 privateInstance 的 bean 的 age 属性 自动 装配 了 string 方法 参 
数 country ° Spring 的 表达 式 语言 元 素 通 过 #{<expression>} 表示 定义 了 属性 的 值 。 对 
于 @value 注解 ， 当 解析 表达 式 文本 时 ， 表 达 式 解析 器 会 预先 配置 来 查看 bean 的 名 称 。 


Spring 组 件 中 的 @Bean 方法 会 被 不 同方 式 处 理 ， 而 不 会 像 Spring 的 @configuration 类 中 的 同 
仁 那 样 。 不 同 的 是 @component 类 没有 使 用 CGLIB 来 加 强 并 拦截 字段 和 方法 的 调用 。CGLIB 


代理 是 调用 @configuration 类 中 的 @Bean 方法 或 字段 来 创建 bean 元 数据 引用 协作 对 象 的 手 


段 。 方 法 没有 使 用 通常 的 Java 语义 来 调用 。 相 比 之 下 ， 调 用 普通 的 @component 类 中 
的 @Bean 方法 或 字段 有 标准 的 Java 语义 ， 没 有 特殊 的 CGLIB 处 理 或 其 他 的 限制 应 用 。 


你 可 能 声明 @Bean 为 static ， 人 允许 包含 它们 的 配置 类 没有 创建 为 实例 时 进行 调用 。 这 使 
得 定义 后 置 处 理 器 特别 有 意义 ， 例 如 ， BeanFactoryPostProcessor 或 

BeanPostProcessor ? 由 于 这 样 的 bean 将 在 容器 生命 周期 早期 初始 化 ， 因 此 应 该 避免 在 该 
点 触发 配置 的 其 他 部 分 。 

注意 ， 调 用 静态 的 @Bean 方法 将 不 会 被 容器 拦截 ， 即 使 是 在 @configuration 类 里 (看 上 
面 ) 。 这 是 由 于 技术 上 的 局 限 性 : CGLIB 的 子 类 仅仅 可 以 重 载 非 静 态 的 方法 。 因 此 ， 直 
接 调用 另 一 个 @Bean 方法 将 会 有 标准 的 Java 语 义 ， 从 而 直接 从 工厂 方法 返回 一 个 独立 的 

实例 。 

在 Spring 容器 中 ， @Bean 方法 的 Java 语 言 可 视 性 并 没有 直接 对 bean 的 定义 产生 影响 。 你 

可 以 自由 地 声明 你 自己 的 工厂 方法 填充 到 非 @Configuration 类 中 ， 也 可 以 是 静态 方法 。 

当然 ， 在 @configuration 类 中 合格 的 @Bean 方法 应 该 是 可 重 写 的 ， 也 就 是 说 ， 你 不 应 该 
声明 为 private 或 final 类 型 。 最 后 ，@Bean 也 可 以 用 在 给 定 组 件 或 配置 类 的 基 类 上 ， 
以 及 Java 8 的 默认 方法 声明 的 被 组 件 或 配置 类 实现 的 接口 。 这 使 得 更 灵活 地 组 成 复杂 的 

配置 结构 ， 甚 至 在 Spring 4.2， 多 重 继 承 可 以 通过 java 8 的 默认 方法 实现 。 


6.10.6 Naming autodetected components 


当 组 件 被 自动 检测 作为 扫描 进程 的 一 部 分 时 ， 它 的 bean 名 称 是 由 BeanNameGenerator 策略 
来 生成 并 告知 扫描 器 的 。 默 认 情 况 下 ，Spring 构造 型 的 注解 

( @Component ， @Repository °’ @Service 和 @Controller ) 包含 name 值 将 会 提供 该 值 
给 对 应 bean 定义 的 名 称 。 如 果 注 解 不 包含 name 值 或 任何 被 检测 到 的 组 件 (比如 那些 被 
自 定义 过 滤器 发 现 的 ) ， 默 认 的 bean 的 名 称 生成 器 返回 未 大 写 的 非 限定 符 类 名 。 比 如 ， 
如 果 下 面 的 两 个 组 件 被 检测 到 了 ， 那 么 名 称 可 能 是 myMovieLister 和 movieFinderlmpl : 


@Service("myMovieLister") 

public class SimpleMovieLister { 
HE a 

} 

@Repository 

public class MovieFinderImpl implements MovieFinder { 
OA 
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如 果 你 不 想 使 用 默认 的 bean 命名 策略 ， 你 可 以 提供 自 定义 的 bean 命名 策略 。 首 先 ， 实 
现 BeanNameGenerator 接口 ， 要 保证 包含 默认 的 无 参 构造 器 。 之 后 ， 在 配置 打 描 器 时 ， 要 
提供 类 的 完全 限定 名 。 


@Configuration 

@ComponentScan(basePackages = "org.example", nameGenerator = MyNameGenerator.clas 
s) 

public class AppConfig { 


} 
<beans> 
<context:component-scan base-package="o0rg.example" 
name-generator="org.example.MyNameGenerator" /> 
</beans> 


作为 通用 的 规则 ， 要 考虑 使 用 注解 指定 名 称 时 ， 其 它 组 件 可 能 会 有 对 它 的 明确 的 引用 。 
另 一 方面 ， 当 容器 负责 装配 时 ， 自 动 生成 名 称 是 可 行 的 。 


6.10.7 Providing a scope for autodetected components 


一 般 情 况 下 ，Spring 管理 的 组 件 ， 自 动 检测 组 件 默认 和 最 多 使 用 的 作用 域 是 单 例 。 然 
而 ， 有 时 你 需要 其 它 作用 域 ，Spring 2.5 提供 了 一 个 新 的 @scope 注解 。 仅 仅 需要 提供 作 
用 域 的 名 称 到 注解 上 : 


@Scope("prototype") 

@Repository 

public class MovieFinderImpl implements MovieFinder { 
Ul cect 


为 作用 域 提供 自 定 义 策 略 而 不 是 基于 注解 的 方式 ， 实 现 scopeMetadataResolver 接口 ， 并 
保证 包含 了 默认 的 无 参 构 造 方法 。 之 后 ， 当 配置 扫描 器 时 ， 要 提供 类 的 完全 限定 名 : 


@Configuration 

@ComponentScan(basePackages = "org.example", scopeResolver = MyScopeResolver.clas 
s) 

public class AppConfig { 


J 
<beans> 
<context:component-scan base-package="org.example" 
scope-resolver="org.example.MyScopeResolver" /> 
</beans> 
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当 使 用 确定 的 非 单 例 作 用 域 时 ， 它 可 能 必须 要 为 该 作用 域 的 对 象 生 成 代理 。 这 个 原 
在 “Scoped beans as dependencies” 章 节 中 描述 过 了 。 出 于 这 样 的 目的 ， 在 component- 
scan 元 素 中 可 以 使 用 scoped-proxy 属性 。 三 种 可 能 的 值 是 : no (无 ) ， interface ( 接 


u) 和 targetClass (目标 类 ) 。 上 比如， 下面 的 配置 就 会 启动 标准 的 JDK 动态 代理 : 


@Configuration 

@ComponentScan(basePackages = "org.example", scopedProxy = ScopedProxyMode. INTERF 
ACES) 

public class AppConfig { 


} 
<beans> 
<context:component-scan base-package="org.example" 
scoped-proxy="interfaces" /> 
</beans> 


6.10.8 Providing qualifier metadata with annotations 


@Qualifier 注解 在 “Fine-tuning annotation-based autowiring with qualifiers” = 7 P 147 

过 了 。 那 章节 中 演示 了 @qualifier 注解 的 使 用 和 当 你 需要 处 理 自动 装配 候选 者 时 ， 自 定 
义 限 定 符 注解 来 提供 细 粒 度 控制 。 因 为 那些 示例 是 基于 XML 的 bean 定义 的 ， 限 定 符 元 
数据 在 候选 者 bean 定义 中 提供 ， 并 使 用 了 XML 中 的 bean 元 素 的 qualifier 和 meta 
Free 当 对 自动 检测 组 件 使 用 基于 类 路 径 扫描 时 ， 你 可 以 在 候选 者 类 中 使 用 类 型 级 别 
的 注解 提供 限定 符 元 数据 。 下 面 的 三 个 示例 就 展示 了 这 个 技术 : 


@Component 

@Qualifier ("Action") 

public class ActionMovieCatalog implements MovieCatalog { 
Ue cece 

iF 

@Component 

@Genre("Action" ) 

public class ActionMovieCatalog implements MovieCatalog { 
HG wit 

y 

@Component 

@offline 

public class CachingMovieCatalog implements MovieCatalog { 
We vai 

J 


对 于 大 多 数 基 于 注解 的 方式 ， 要 记得 注解 元 数据 会 绑 定 到 类 定义 本 身 中 去 ， 而 使 用 XML 


就 允许 对 多 个 相同 类 型 的 bean 在 它们 的 限定 符 元 数据 中 提供 变化 ， 因 为 那些 元 数据 是 对 
于 每 个 实例 而 不 是 每 个 类 提供 的 。 
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6.11 Using JSR 330 Standard Annotations 
JA Spring 3.0 #48 > Spring 提供 了 对 JSR-330 标准 注解 (依赖 注入 ) 的 支持 。 这 些 注 解 可 以 
和 Spring 注解 以 相同 方式 被 扫描 到 。 你 仅仅 需要 在 类 路 径 下 添加 相关 的 jar 包 即 可 。 


如 果 你 使 用 Maven， 那 么 标准 Maven 仓 库 
[http://repo1.maven.org/maven2/javax/inject/javax.inject/1/] 中 javax.inject 的 artifact 是 可 用 
的 。 你 仅仅 需要 在 pom.xml 中 添加 如 下 的 依赖 即 可 : 


<dependency> 
<groupId>javax.inject</groupId> 
<artifactId>javax.inject</artifactId> 
<version>1</version> 


</dependency> 


6.11.1 Dependency Injection with @Inject and @Named 
取代 @Autowired ， javax.inject.Inject 还 可 以 像 下 面 这 样 使 用 : 


import javax.inject.Inject; 
public class SimpleMovieLister { 
private MovieFinder movieFinder; 
@Inject 
public void setMovieFinder(MovieFinder movieFinder) { 


this.movieFinder = movieFinder; 


} 


Ud wie 


与 @Autowired 一 样 ， 可 以 在 类 级 别 ， 字 段 级 别 ， 方 法 级 别 和 构造 方法 参数 级 别 使 
用 @tInject 。 如 果 你 想 对 被 注入 的 依赖 使 用 限定 符 名 称 ， 你 应 该 按 如 下 方式 使 用 @Named 注 
解 : 


import javax.inject.Inject; 
import javax.inject.Named; 


public class SimpleMovieLister { 
private MovieFinder movieFinder; 
@Inject 


public void setMovieFinder(@Named("main") MovieFinder movieFinder) { 
this.movieFinder = movieFinder; 


UP o.0 9 


6.11.2 @Named: a standard equivalent to the @Component 
annotation 


取代 @Component ， javax.inject.Named 还 可 以 像 下 面 这 样 使 用 : 


import javax.inject.Inject; 
import javax.inject.Named; 


@Named("movieListener" ) 
public class SimpleMovieLister { 


private MovieFinder movieFinder; 
@Inject 


public void setMovieFinder(MovieFinder movieFinder) { 
this.movieFinder = movieFinder; 


UO tse 


使 用 @component 而 不 指定 组 件 的 名 称 是 很 常用 的 方式 。 @Named 可 以 被 用 于 相同 的 情况 : 


import javax.inject.Inject; 
import javax.inject.Named; 


@Named 
public class SimpleMovieLister { 


private MovieFinder movieFinder; 


@Inject 
public void setMovieFinder(MovieFinder movieFinder) { 
this.movieFinder = movieFinder; 


} 


VEEE 


当 使 用 @Named 时 ， 可 以 使 用 相同 的 方式 使 用 Spring 注解 的 组 件 扫描 : 


@Configuration 
@ComponentScan(basePackages = "org.example") 
public class AppConfig { 


} 


6.11.3 Limitations of the standard approach 


当 使 用 标准 注解 时 ， 了 解 一 些 很 重要 的 特性 是 不 可 用 的 是 很 有 必要 的 ， 在 下 面 的 表格 中 给 
出 : 表 6.6 Spring 注解 和 标准 注解 的 对 比 
Spring javax.inject.* javax.inject 限制 / 注释 
@Autowired @lnject @lnject 没有 'required' 属性 
@Component @Named 


jsr-330 默认 范围 和 Spring 的 prototype 相 似 。 但 是 ， 
要 保持 和 Spring 一 般 默 认 值 一 致 ， 存 Spring 容器 中 


@Scope(" @Singleton jsr-330 的 bean 声明 默认 是 singleton 的 。 要 使 用 另 

singleton " ) g 外 的 范围 ， 你 应 该 使 用 Spring 的 @Scope 注解 。 
javax.inject 也 供 @Scope 注解 。 不 过 这 仅仅 用 于 创建 
你 自己 的 注解 。 

@Qualifier @Named 

@Value - 不 等 同 

@Required - 不 等 同 


@Lazy - 不 等 同 


使 用 JSR 330 标 准 注解 
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6.12 Java-based container configuration 


6.12.1 Basic concepts: @Bean and @Configuration 
Spring 中 新 的 Java 配置 支持 的 核心 就 是 @configuration 注解 的 类 和 @Bean 注解 的 方法 。 


@Bean 注解 用 来 指定 一 个 方法 实例 ， 配 置 和 初始 化 一 个 新 对 象 交 给 Spring IOC 容 器 管理 。 对 
于 那些 熟悉 Spring <beans> XML 配置 的 人 来 说 ， @Bean 注解 和 <bean> 元 素 扮 演 相 同 的 角色 。 
你 可 以 使 用 在 @Component 类 中 使 用 @Bean 注解 方法 但 更 常用 的 ， 是 在 @Configuration 类 中 
使 用 。 


@Configuration 注解 的 类 表示 它 的 主要 目的 是 作为 bean 定 义 的 RMR ° A 
外 ” @Configuration 类 允许 内 部 bean 依 赖 通过 简 单 地 调用 同一 类 内 的 其 他 @Bean 方法 进行 定 
义 。 最 简单 的 @configuration 类 可 能 是 这 样 的 : 


@Configuration 
public class AppConfig { 


@Bean 
public MyService myService() { 
return new MyServiceImpl(); 


} 


上 面 Appconfig 类 与 下 面 Spring XML 中 的 配置 是 等 同 的 : 


<beans> 


<bean id="myService" class="com.acme.services.MyServiceImp1"/> 
</beans> 


Full @Configuration vs 'lite' @Beans mode? % @Bean 方法 不 是 在 @Configuration Y * 
明 时 ， 被 称 为 ite’ mode。 例 如 ，bean 方 法 在 @component 或 甚至 在 简单 的 PO 类 中 声明 ， 
都 被 认为 是 'lite'。 

5 full @configuration 不 同 的 是 ，lite @Bean 方法 无 法 声明 内 部 bean 依 赖 。 通 常 ， 当 

在 lite mode 下 时 一 个 @Bean 方法 不 应 该 调用 另 一 个 @Bean 方法 。 

只 有 在 @configuration 类 下 使 用 @Bean 方法 是 被 推荐 的 ， 确 保 fulhmode 经 常 使 用 到 。 这 
将 阻止 被 同一 个 aean 方法 意外 地 多 次 调用 ， 帮 助 减少 在 lite mode 下 出 现 的 难以 追踪 
的 bugs。 


@Bean 和 @Configuration 注解 将 会 在 下 面 的 章节 中 被 深入 地 探讨 。 首 先 ， 我 们 先 来 看 看 使 用 
基于 Java 的 配置 创建 Spring 容器 的 各 种 方 式 。 


6.12.2 Instantiating the Spring container using 
AnnotationConfigApplicationContext 


ee est Spring 的 AnnotationConfigApplicationContext ， 是 在 Spring3.0 中 新 加 入 
的 。 这 个 全 能 的 Applicationcontext 实现 类 不 仅仅 可 以 接受 @configuration 类 作为 输入 ， 也 

可 以 是 普 通 的 @Component 类 ， 还 有 使 用 JSR-330 元 数据 注解 的 类 to 当 @Configuration 类 作 

为 输入 时 ? @Configuration 类 本 身 作 为 bean 被 注册 了 ， 并 且 类 内 所 有 声 明 的 @Bean 方法 也 

被 作为 bean 注册 了 。 3 @Component 和 JSR-330 类 作为 输入 时 ? 它们 被 注册 为 bean ， 并 且 
被 假设 如 @Autowired 或 @Inject 的 DI 元 数据 在 类 中 需要 的 地 方 使 用 。 


简单 构造 


与 使 用 Spring XML 配置 作为 输入 实例 化 classPathxmlapplicationContext AU 当 实 例 
化 AnnotationConfigApplicationContext 时 @Configuration 类 可 能 作为 输 AS 这 就 允许 在 
Spring 容器 中 完全 可 以 不 使 用 XML : 


public static void main(String[] args) { 
ApplicationContext ctx = new AnnotationConfigApplicationContext(AppConfig.class); 
MyService myService = ctx.getBean(MyService.class); 
myService.doStuff(); 


正如 上 面 所 提 到 的 ， AnnotationConfigApplicationContext 不 仅仅 局 限于 和 @Configuration 类 
合作 2 任意 @Component 或 JSR-330 注解 的 类 都 可 以 作为 构造 方法 的 输入 。 比 如 : 


public static void main(String[] args) { 

ApplicationContext ctx = new AnnotationConfigApplicationContext (MyServiceImpl.clas 
s, Dependency1.class, Dependency2.class); 

MyService myService = ctx.getBean(MyService.class); 

myService.doStuff(); 


上 面 假设 MyserviceImpl ， Dependency1 和 Dependency2 使 用 了 Spring 依赖 注入 注解 ， 比 
如 @Autowired ° 


使 用 register(Class<?>...) 编 程式 构建 容器 


AnnotationConfigApplicationContext 可 以 使 用 无 参 构 造 方法 来 实例 化 ， 之 后 使 
用 register() 方法 来 配置 。 这 个 方法 当 编程 式 地 构建 AnnotationConfigApplicationContext 时 
尤其 有 用 。 


public static void main(String[] args) { 
AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(); 
ctx.register(AppConfig.class, OtherConfig.class); 
ctx. register (AdditionalConfig.class); 
ctx.refresh(); 


MyService myService = ctx.getBean(MyService.class); 
myService.doStuff(); 


使 用 Scan(String..) 开 局 组 件 扫描 
要 开启 组 件 扫描 ， 仅 仅 需要 在 你 的 @configuration 类 上 加 上 如 下 注解 : 


@Configuration 
@ComponentScan(basePackages = "com.acme" 
public class AppConfig { 


有 经 验 的 Spring 用 户 肯 定 会 熟悉 下 面 这 个 Spring 的 context: 命名 空间 中 的 常用 XML 
aR: 


<beans> 


<context:component-scan base-package="com.acme"/> 
</beans> 


在 上 面 的 示例 中 > com.acme 包 会 被 扫描 到 > 去 查找 任意 @Component 注解 的 类 那些 类 就 会 被 
注册 为 Spring 容器 中 的 bean。 AnnotationConfigApplicationContext 暴露 出 scan(String 


...) 方法 ， 允 许 相同 的 组 件 扫 描 功 能 : 


public static void main(String[] args) { 


AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(); 
ctx.scan("com.acme"); 
ctx.refresh(); 


MyService myService = ctx.getBean(MyService.class); 


B7 


记得 @Configuration 类 是 使 用 @component 进行 元 数据 注解 的 ， 所 以 它们 是 组 件 扫描 的 候 
选 者 ! 在 上 面 的 示例 中 > 假设 AppConfig 是 声明 在 com.acme & (或 是 其 中 的 子 包 ) 中 
的 ， 那 么 会 在 调用 scan() 方法 时 被 找到 ， 在 调用 refresh() FAN? HAC 

的 @Bean 方法 就 会 被 处 理 并 注册 为 容器 中 的 bean。 


支持 Web 应 用 的 AnnotationConfigwebApplicationContext 


WebApplicationContext 是 AnnotationConfigApplicationContext 的 变种 ， 适 用 于 


AnnotationConfigwebApplicationContext ° 4 42a Spring 的 Servlet 监听 
ContextLoaderListener ° Spring MVC 的 Dispatcherservlet 等 时 ， 这 个 实现 类 就 可 能 被 


aa 


用 到 了 。 下 面 的 代码 是 在 web.xml 中 的 片段 ， 配置 了 典型 的 Spring MVC 的 Web 应 用 程 
序 。 注 意 contextClass 上 下 文 参数 和 初始 化 参数 的 使 用 : 


<web-app> 
<!-- Configure ContextLoaderListener to use AnnotationConfigwebApplicationContext 


instead of the default XmlWebApplicationContext --> 


<context -param> 
<param-name>contextClass</param-name> 


<param-value> 
org.springframework.web.context.support.AnnotationConfigwebApplicationCont 


ext 
</param-value> 
</context -param> 
<!-- Configuration locations must consist of one or more comma- or space-delimited 
fully-qualified @Configuration classes. Fully-qualified packages may also be 
specified for component-scanning --> 
<context -param> 
<param-name>contextConfigLocation</param-name> 
<param-value>com.acme.AppConfig</param-value> 
</context -param> 
<!-- Bootstrap the root application context as usual using ContextLoaderListener - 
-> 
<listener> 
<listener-class>org.springframework.web.context.ContextLoaderListener</listene 
r-class> 
</listener> 
<!-- Declare a Spring MVC DispatcherServlet as usual --> 
<servlet> 
<servlet -name>dispatcher</servlet -name> 
<servlet-class>org.springframework.web.servlet .DispatcherServlet</servlet-clas 
s> 
<!-- Configure DispatcherServlet to use AnnotationConfigwebApplicationContext 
instead of the default XmlWebApplicationContext --> 
<init-param> 
<param-name>contextClass</param-name> 
<param-value> 
org.springframework.web.context.support.AnnotationConfigwebApplication 
Context 


</param-value> 


</init -param> 
<!-- Again, config locations must consist of one or more comma- or space-delim 


ited 
and fully-qualified @Configuration classes --> 


<init-param> 
<param-name>contextConfigLocation</param-name> 


<param-value>com.acme.web.MvcConfig</param-value> 
</init -param> 
</servlet> 


<!-- map all requests for /app/* to the dispatcher servlet --> 
<servlet -mapping> 
<servlet -name>dispatcher</servlet -name> 
<url-pattern>/app/*</url-pattern> 
</servlet -mapping> 
</web -app> 


6.12.3 Using the @Bean annotation 


@Bean 是 一 个 方法 级 的 注解 ， 与 XML 的 <bean/> 元 素 功能 相同 。 该 注解 支持 一 些 <bean/> 上 
的 属性 ， 如 : init-method , destroy-method , autowiring 和 name 。 你 可 以 


在 @Configuration 或 @Component 类 里 使 用 @Bean 注解 。 
声明 一 个 bean 


要 声明 一 个 bean， 可 以 简单 地 使 用 @Bean 注解 到 一 个 方法 上 。 你 可 以 
在 ApplicationContext 容器 中 使 用 这 个 方法 的 返回 值 来 注册 一 个 bean 定 义 。 上 默认 的 ，bean 的 
名 称 将 会 与 方法 的 名 称 相 同 。 下 面 是 一 个 @Bean 声明 的 简单 示例 : 


@Configuration 
public class AppConfig { 


@Bean 


public TransferService transferService() { 
return new TransferServiceImpl(); 


上 述 配置 是 完全 与 下 面 的 Spring XML 相等 的 : 


<beans> 


<bean id="transferService" class="com.acme.TransferServiceImp1"/> 
</beans> 


两 者 的 声 明 都 在 ApplicationContext 中 创建 了 一 个 名 为 transferservice 的 bean， RET aa 
AN TransferServiceImpl 类 型 的 实例 对 象 : 


transferService -> com.acme. TransferServicelmpl 


Beantk #i 


@Bean 注解 的 方法 可 以 有 任意 数量 的 参数 依赖 来 构建 bean。 比 如 ， 如 果 我 们 
的 TransferService 要 求 一 个 AccountRepository ， 我 们 可 以 具体 化 该 依赖 通过 一 个 方法 参 
数 : 


@Configuration 
public class AppConfig { 


@Bean 
public TransferService transferService(AccountRepository accountRepository) { 
return new TransferServiceImpl(accountRepository) ; 


这 个 解析 机 制 与 基于 构造 器 的 依赖 注入 非常 相似 ， 详 情 查看 “Constructor-based dependency 
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injection” = P ° 


接收 生命 周期 回调 
任何 使 用 @Bean 注解 定义 的 类 都 支持 定期 的 生命 周期 回调 ， 可 以 使 用 JSR-250 
的 @PostConstruct 和 @PreDestroy 注解 > 详情 查看 6.9.8 @PostConstruct and @PreDestroy 


定期 的 生命 周 期 回调 得 到 了 很 好 地 支持 。 如 果 一 个 bean 实 现 了 InitializingBean , 
DisposableBean , Or Lifecycle 接口 ， 他 们 各 自 的 方法 将 会 被 容器 调用 。 


标 准 的 一 套 *Aware 接口 ， 例如 ， BeanFactoryAware , BeanNameAware , MessageSourceAware , 
ApplicationContextAware 等 等 也 一 样 得 到 了 很 好 的 支持 F 


@Bean 注解 支持 指定 任意 的 初始 化 和 销毁 的 回调 方法 ， 非 常 类 似 于 Spring XML 中 bean 元 素 
的 init-method 和 destroy-method 属性 : 


public class Foo { 
public void init() { 
// initialization logic 


public class Bar { 
public void cleanup() { 
// destruction logic 


@Configuration 
public class AppConfig { 


@Bean(initMethod = "init") 
public Foo foo() { 
return new Foo(); 


@Bean(destroyMethod = "cleanup" ) 
public Bar bar() { 
return new Bar(); 


默认 地 ， 使 用 Java 配 置 的 bean 定 义 有 public 的 close 或 shutdown 方法 时 ， 在 销毁 回调 时 会 被 
自动 地 调用 。 所 以 如 果 你 有 public 的 close 或 shutdown 方法 ， 而 你 不 想 它 在 容器 关闭 时 被 调 
用 ， 那 你 可 以 简单 地 加 上 @Bean(destroyMethod="") 到 你 的 bean 定 义 上 ， 以 此 来 使 默认 

的 (inferred) 行为 失效 。 


你 可 以 想 默 认 地 通过 JNDI 获 取 你 需要 的 在 应 用 之 外 管理 的 资源 作为 它 的 生命 周期 。 特 别 地 ， 
一 定 要 始终 做 一 个 Datasource ， 因 为 它 是 已 知 的 有 问题 的 : 


@Bean(destroyMethod="" ) 
public DataSource dataSource() throws NamingException { 
return (DataSource) jndiTemplate.lookup("MyDS"); 


当然 ， 上面 Foo 的 示例 ， 它 等 同 于 在 构造 期 间 调 用 init() 方法 : 


@Configuration 
public class AppConfig { 
@Bean 
public Foo foo() { 
Foo foo = new Foo(); 
foo.init(); 
return foo; 


Yk nse 


当 你 完全 使 用 Java 配 置 ， 你 对 你 的 对 象 可 以 做 任何 你 想 做 的 ， 不 要 总 必须 依赖 于 容器 的 


指定 bean 的 作用 域 
使 用 @scope 注解 


你 可 以 指定 使 用 @Bean 注解 的 bean 定 义 应 该 有 个 指定 的 作用 域 。 你 可 以 使 用 任何 在 6.5 章 节 
Bean scopes 中 提 到 的 标准 的 作用 域 。 


默认 的 作用 域 是 singleton ， 但 你 可 以 使 用 @scope 注解 进行 覆盖 : 


@Configuration 
public class MyConfiguration { 


@Bean 

@Scope("prototype") 

public Encryptor encryptor() { 
Wl sees 


} 


@Scope 和 scoped-proxy 


Spring 提供 了 一 个 便利 的 途径 ， 通 过 作用 域 代 理 处 理 作用 域 依赖 。 当 使 用 XML 配置 时 ， 最 简 
单 的 方法 创建 这 样 一 个 代理 就 是 使 用 <aop:scoped-proxy/> 元 素 © 在 Java 中 使 用 @Scope 注解 
带 proxyMode 属性 来 配置 你 的 beans 是 等 价 的 2 默认 的 是 没有 代理 ( ScopedProxyMode.NO ) 2 


但 你 可 以 指定 ScopedProxyMode.TARGET_CLASS 或 ScopedProxyMode .INTERFACES ° 


// an HTTP Session-scoped bean exposed as a proxy 
@Bean 
@Scope(value = "Session", proxyMode = ScopedProxyMode.TARGET_CLASS) 
public UserPreferences userPreferences() { 
return new UserPreferences(); 


@Bean 

public Service userService() { 
UserService service = new SimpleUserService(); 
// a reference to the proxied userPreferences bean 
service.setUserPreferences(userPreferences()); 


return service; 


自 定 义 bean 命 名 


默认 地 ， 配 置 类 使 用 @Bean 方法 的 名 称 来 作为 注册 bean 的 名 称 。 这 个 方法 可 以 被 重 写 ， 当 
然 使 用 的 是 name 属 小 9 


@Configuration 
public class AppConfig { 


@Bean(name = "myFoo") 
public Foo foo() { 
return new Foo(); 


Bean 混淆 现象 

在 6.3.1 , “Naming beans” 章节 讨论 过 ， 有 时 需要 对 单个 bean 使 用 多 个 名 称 才能 满足 需要 ， 
否则 就 会 有 bean 混 淆 现象 ° @Bean 注解 的 name 属性 为 了 达到 该 目 的 可 以 接收 一 个 字符 串 数 
组 。 


@Configuration 
public class AppConfig { 


@Bean(name = { "dataSource", "subsystemA-dataSource", "subsystemB-dataSource" }) 
public DataSource dataSource() { 
// instantiate, configure and return DataSource bean... 


Bean 描述 


有 时 提供 一 个 更 详细 的 bean 的 文本 描述 是 很 有 帮助 的 。 这 是 特别 有 用 当 beans 用 于 (可 能 通 
过 JMX) 监测 的 目的 。 


使 用 @Description 注解 来 对 @Bean 添加 一 个 描述 : 


@Configuration 
public class AppConfig { 


@Bean 
@Description("Provides a basic example of a bean") 
public Foo foo() { 

return new Foo(); 


} 


6.12.4 Using the @Configuration annotation 


@Configuration 是 一 个 类 级 别 的 注解 ， 用 于 表明 此 对 象 是 一 个 bean 定 义 的 资 
源 。 @Configuration 类 通过 public 的 @Bean 注解 的 方法 来 声 明 beans。 调 用 @Configuration 类 
的 @Bean 方法 也 可 以 被 用 于 定义 jnter-bean 依 赖 。 详 情 查 看 6.12.1, “Basic concepts: @Bean 
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and @Configuration”"=* ° 


Injecting inter-bean dependencies 
4 @Beans 上 有 其 它 bean 的 依赖 ， 简 单 演示 一 个 bean 方 法 调用 另 一 个 : 


@Configuration 
public class AppConfig { 


@Bean 
public Foo foo() { 
return new Foo(bar()); 


} 


@Bean 
public Bar bar() { 
return new Bar(); 


} 


在 上 面 的 例子 中 ， foo bean 通 过 构造 器 注入 接收 了 一 个 bar 引用 。 


这 个 声明 inter-bean 依 赖 的 方法 只 会 在 @Bean 声明 在 @configuration 类 下 时 才 会 起 效 。 
你 不 能 使 用 简单 的 @component 类 声明 inter-bean 依 赖 。 


查找 方法 注入 


如 前 所 述 ， 查 找 方法 注入 是 一 个 高 级 特性 ， 你 应 该 很 少 会 用 到 。 当 一 个 singleton 作 用 域 的 
bean 有 一 个 prototype 作 用 域 bean 的 依赖 时 ， 这 将 很 有 用 。 对 于 Java 配 置 ， 提 供 了 一 种 自然 的 
方式 实现 这 一 模式 : 


public abstract class CommandManager { 
public Object process(Object commandState) { 
// grab a new instance of the appropriate Command interface 
Command command = createCommand(); 


// set the state on the (hopefully brand new) Command instance 
command.setState(commandState) ; 
return command.execute(); 


} 


// okay... but where is the implementation of this method? 
protected abstract Command createCommand(); 


使 用 Java 配 置 支持 你 可 以 创建 一 个 CommandManager 的 子 类 ， 其 虚 方 法 createCommand() 将 会 
被 重 写 ， 通 过 此 种 方式 ， 来 查找 一 个 新 的 〈prototype) {commande % ° 


@Bean 

@Scope("prototype") 

public AsyncCommand asyncCommand() { 
AsyncCommand command = new AsyncCommand(); 
// inject dependencies here as required 
return command; 


@Bean 
public CommandManager commandManager() { 
// return new anonymous implementation of CommandManager with command() overridden 
// to return a new prototype Command object 
return new CommandManager() { 
protected Command createCommand() { 
return asyncCommand(); 


Further information about how Java-based configuration 
works internally 


下 面 的 例子 展示 了 @Bean 注解 的 方法 被 调用 了 2 次 : 


@Configuration 
public class AppConfig { 


@Bean 

public ClientService clientServicei1() { 
ClientServiceImpl clientService = new ClientServiceImp1(); 
clientService.setClientDao(clientDao()); 
return clientService; 


} 


@Bean 

public ClientService clientService2() { 
ClientServiceImpl clientService = new ClientServiceImp1(); 
clientService.setClientDao(clientDao()); 
return clientService; 


} 


@Bean 
public ClientDao clientDao() { 
return new ClientDaoImpl(); 


} 


clientDao() 在 clientService1() Doan ， 在 clientService2() 也 被 调用 一 次 。 从 这 
个 方法 创建 一 个 clientpaoImpl 实例 并 返 ， 你 通常 期 望 会 生成 2 个 实例 (每 个 service 一 
个 ) 。 那 肯定 是 有 问题 的 : 在 Spring 中 ， 化 beans 默 认 拥有 一 个 singleton 作 用 域 。 这 就 是 
神奇 的 地 方 : 所 有 的 @configuration 类 在 启动 的 阶段 使 用 CGLIB 进 行 子 类 化 。 在 子 类 中 ， 子 
方法 首先 检查 容器 中 任何 缓存 (scoped) 的 beans 在 它 调用 父 方法 及 创建 新 的 实例 之 前 。 注 
意 ，Spring3.2 已 经 不 再 需要 添加 CGLIB 到 你 的 classpath 中 了 ， 因 为 CGLIB 类 已 经 被 打包 

到 org.springframework ， 并 被 包含 到 spring-core JAR 包 中 了 。 


根据 你 的 bean 的 作用 域 的 不 同 ， 行 为 可 能 会 有 所 不 同 。 我 们 这 里 仅 谈论 了 singltons。 
由 于 CGLIB 在 启动 期 间 动 态 添加 特性 ， 所 以 这 里 有 几 个 限制 : 


n 


e 配置 类 必须 不 能 为 final 


e@ 应 该 有 一 个 无 参 的 构造 器 


6.12.5 Composing Java-based configurations 


使 用 @Import 注解 


就 像 Spring 的 XML 文件 中 使 用 的 <import/> 元 素 帮 助 模块 化 配置 一 样 ， @Import 注解 允许 
从 其 它 配 置 类 中 加 载 @Bean 的 配置 : 


@Configuration 
public class ConfigA { 


@Bean 
public A a() { 
return new A(); 


@Configuration 
@Import(ConfigA.class) 
public class ConfigB { 


@Bean 
public B b() { 
return new B(); 


现在 ， 当 实例 化 上 下 文 时 ， 不 需要 指定 configA.class 和 ConfigB.class 了 ， 仅 仅 ConfigB 


public static void main(String[] args) { 
ApplicationContext ctx = new AnnotationConfigApplicationContext(ConfigB.class); 


// now both beans A and B will be available... 
A a = ctx.getBean(A.class); 
B b = ctx.getBean(B.class); 


这 种 方式 简化 了 容器 的 实例 化 ， 仅 仅 是 一 个 类 需要 被 处 理 ， 而 不 是 需要 开发 人 员 在 构造 时 记 
住 很 多 大 量 的 @Configuration 类 。 


在 引入 的 @Bean 定 义 中 注入 依赖 


上 面 的 示例 是 可 行 的 ， 但 是 太 过 简单 。 在 很 多 实际 场景 中 ，bean 会 有 依赖 其 它 配置 的 类 的 依 
赖 。 当 使 用 XML 时 ， 这 本 身 不 是 什么 问题 ， 因 为 没有 调用 编译 器 ， 而 且 我 们 可 以 仅仅 声明 
ref="someBean" 并 且 相 信 Spring 在 容器 初始 化 时 可 以 完成 。 当 然 ， 当 使 用 @Configuration 的 
类 时 ，Java 编译 器 在 配置 模型 上 放置 约束 ， 对 其 它 bean 的 引用 必须 是 符合 Java 语法 的 。 


幸运 的 是 ， 解 决 这 个 问题 非常 简单 。 我 们 已 经 讨论 过 了 > @Bean 方法 可 以 有 任意 个 参数 声明 
bean 依 赖 。 让 我 们 考虑 一 个 更 扶 实 的 场景 ， 有 个 @configuration 类 ， 每 个 bean 都 依赖 其 他 的 
配置 中 声明 的 bean : 


@Configuration 
public class ServiceConfig { 


@Bean 
public TransferService transferService(AccountRepository accountRepository) { 
return new TransferServiceImpl(accountRepository) ; 


@Configuration 
public class RepositoryConfig { 


@Bean 
public AccountRepository accountRepository(DataSource dataSource) { 
return new JdbcAccountRepository(dataSource) ; 


@Configuration 
@Import({ServiceConfig.class, RepositoryConfig.class}) 
public class SystemTestConfig { 


@Bean 
public DataSource dataSource() { 
// return new DataSource 


public static void main(String[] args) { 
ApplicationContext ctx = new AnnotationConfigApplicationContext(SystemTestConfig.c 
lass); 
// everything wires up across configuration classes... 
TransferService transferService = ctx.getBean(TransferService.class); 
transferService.transfer(100.00, "A123", "C456"); 


AA 外 一 种 方法 可 以 达到 一 样 的 结果 9 记 住 @Configuration 类 有 最终 是 容器 中 的 A 外 一 个 
bean : 也 就 是 说 它们 可 以 像 其 它 bean 那样 利用 @autowired 注入 元 数据 | 


基于 Java 的 容器 配置 


要 确定 这 种 方式 的 依赖 注入 是 最 简单 的 那 种 。 @configuration 类 在 容器 初始 化 时 就 进行 
处 理 了 ， 强 制 要 求 依赖 使 用 这 种 方式 进行 注入 可 能 导致 意外 的 早期 初始 化 问题 。 如 果 可 
能 ， 就 采用 如 上 述 例子 所 示 的 基于 参数 的 注入 。 同时， 也 要 特别 小 心 通 


过 @Bean 的 BeanPostProcessor BeanFactoryPostProcessor 定义 由 它们 应 该 被 声 明 为 


static 的 @Bean 方法 ， 不 会 触发 实例 化 它们 的 包含 类 。 否 则 ， @autowired 和 @value 将 在 


配置 类 上 不 生效 ， 因 为 它 太 早 被 创建 为 一 个 实例 了 。 
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@Configuration 
public class ServiceConfig { 


@Autowired 
private AccountRepository accountRepository; 


@Bean 
public TransferService transferService() { 
return new TransferServiceImpl(accountRepository) ; 


@Configuration 
public class RepositoryConfig { 


@Autowired 
private DataSource dataSource; 


@Bean 
public AccountRepository accountRepository() { 
return new JdbcAccountRepository(dataSource) ; 


@Configuration 
@Import({ServiceConfig.class, RepositoryConfig.class}) 
public class SystemTestConfig { 


@Bean 
public DataSource dataSource() { 
// return new DataSource 


public static void main(String[] args) { 
ApplicationContext ctx = new AnnotationConfigApplicationContext(SystemTestConfig.c 
lass); 
// everything wires up across configuration classes... 
TransferService transferService = ctx.getBean(TransferService.class); 
transferService.transfer(100.00, "A123", "C456"); 


在 上 面 的 场景 中 ， 使 用 @autowired 工作 正常 ， 提 供 所 需 的 模块 化 ， 但 是 准确 地 决定 在 哪儿 疡 
明 自 动 装配 的 bean 还 是 有 些 含糊 。 上 比如， 作为 开发 者 来 看 待 serviceconfig ， 你 如 何 准确 知 
道 @Autowired AccountRepository 在 哪里 声明 的 ? 它 没有 显 式 地 出 现在 代码 中 ， 这 可 能 很 不 


。 要 记得 SpringSource Tool suite 提供 工具 可 以 生成 展示 所 有 对 象 是 如 何 装 配 起 来 的 - 那 
a Brera 。 而 有 全， 你 的 Java IDE 可 以 很 容器 发 现 所 有 的 声明 ， 还 有 使 用 的 
AccountRepository 类 型 ， 也 会 很 快 地 给 你 展示 出 @Bean 方法 的 位 置 和 返回 的 类 型 。 


在 这 种 歧义 不 能 接受 ， 你 想 直 接 在 DE 中 从 一 个 econfiguration 类 导航 到 另 一 个 ， 要 考虑 自 
动 装配 配置 类 的 本 身 : 


@Configuration 
public class ServiceConfig { 


@Autowired 
private RepositoryConfig repositoryConfig; 


@Bean 
public TransferService transferService() { 
// navigate 'through' the config class to the @Bean method! 
return new TransferServiceImpl(repositoryConfig.accountRepository()); 


在 上 面 的 情形 中 ， 定 义 accountRepository 是 完全 明确 的 。 而 Serviceconfig 2) X RAS 
到 RepositoryConfig 中 了 ; 这 就 需要 我 们 来 权衡 了 。 这 种 紧 耦 合 可 以 使 用 基于 接口 或 抽象 基 
类 的 @configuration 类 来 减轻 。 考虑 下 面 的 代码 : 


@Configuration 
public class ServiceConfig { 


@Autowired 
private RepositoryConfig repositoryConfig; 


@Bean 
public TransferService transferService() { 
return new TransferServiceImp1l(repositoryConfig.accountRepository()); 


@Configuration 
public interface RepositoryConfig { 


@Bean 
AccountRepository accountRepository(); 


@Configuration 
public class DefaultRepositoryConfig implements RepositoryConfig { 


@Bean 
public AccountRepository accountRepository() { 
return new JdbcAccountRepository(...); 


@Configuration 

@Import({ServiceConfig.class, DefaultRepositoryConfig.class}) // import the concrete c 
onfig! 

public class SystemTestConfig { 


@Bean 
public DataSource dataSource() { 
// return DataSource 


public static void main(String[] args) { 
ApplicationContext ctx = new AnnotationConfigApplicationContext(SystemTestConfig.c 
lass); 
TransferService transferService = ctx.getBean(TransferService.class); 
transferService.transfer(100.00, "A123", "C456"); 


现在 Serviceconfig 和 DefaultRepositoryConfig 的 耦合 就 比较 松 了 ， 并 且 内 建 的 IDE 工具 
也 一 直 有 效 : 对 于 开发 人 员 来 说 会 更 加 简单 地 获取 EE ESCO 实现 类 的 类 型 层次 。 以 
这 种 方式 ， 导 航 @configuration 类 和 它们 的 依赖 就 和 普通 的 基于 接口 代码 的 导航 过 程 没有 任 
何 区 别 了 。 


Conditionally include @Configuration classes or @Bean 
methods 


基于 任意 的 系统 状态 > 使 完 整 的 @Configuration 类 或 单独 的 @Bean 方法 有 条 件 性 地 生效 或 失 
效 是 很 有 用 的 。 一 个 常见 的 例子 就 是 当 一 个 指定 的 profile 已 经 在 Spring 环境 中 生效 时 使 
用 @profile 注解 来 激活 beans ( 详 见 section 6.13.1, “Bean definition profiles” ) 。 


@Profile 注解 是 通过 使 用 一 个 非常 灵活 的 称 为 @conditional 的 注解 实现 
的 。 @Conditional 注解 表示 具 体 的 org.springframework.context.annotation.Condition 实现 者 
应 该 在 @Bean 被 注册 前 先 被 访问 。 


Condition 接口 的 实现 i 简单 地 提供 了 二 个 matches(...) 方法 ， 用 来 返回 true 或 false ° 4%] 
如 ， 以 下 就 是 使 用 @profile 具体 的 condition 实现 : 


@Override 
public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) { 
if (context.getEnvironment() != null) { 
// Read the @Profile annotation attributes 


MultiValueMap<String, Object> attrs = metadata.getAllAnnotationAttributes (Prof 
ile.class.getName()); 


if (attrs != null) { 
for (Object value : attrs.get("value")) { 


if (context.getEnvironment().acceptsProfiles(((String[]) value))) { 
return true; 


} 


return false; 


} 


return true; 


结合 Java 和 和 XML 


Spring 的 @configuration 类 并 不 是 完全 100% 地 支持 Spring XML 替换 的 。 一 些 基 本 特性 ， 比 
如 Spring XML 的 命名 空间 会 保持 在 一 个 理想 的 方式 下 去 配置 容器 。 在 XML 更 便于 使 用 或 是 
必须 要 使 用 的 情况 下 ， 你 也 有 另外 一 个 选择 : 以 “XML 为 中 心 "的 方式 来 实 从 化 容器 ， 比 

如 ， ClassPathXmlApplicationContext ， 或 者 以 "Java A 中 心 ” 的 方式 ， 使 


用 AnnotationconfigurationApplicationContext 和 @ImportResource 注解 来 引入 需要 的 XML ° 


以 “XML 为 中 心 " 使 用 @Configuration 


以 XML 配置 文件 结合 包含 @configuration 类 的 点 对 点 的 方式 来 启动 Spring 容器 是 更 好 的 选 
择 。 比 如 ， 在 使 用 了 Spring XML 配置 的 大 型 的 代码 库 中 ， 根 据 需要 从 已 有 的 XML 文件 中 创 
建 @configuration 类 是 很 简单 的 。 在 下 面 ， 你 会 发 现在 这 种 “XML 为 中 心 " 情 形 下 ， 使 

用 @Configuration 类 的 选项 。 记 住 ， @Configuration 类 最 终 仅 仅 是 容器 中 的 bean 。 在 这 个 
示例 中 ， 我 们 创建 了 名 为 Appconfig 的 @configuration 类 ， 并 且 将 它 包含 在 system-test- 
config. xml 文件 中 作为 <bean/> 的 定义 。 因 为 开启 了 <context:annotation-config/> 配置 ， 容 
器 会 识别 @configuration 注解 ， 并 以 合适 的 方式 处 理 声 明 在 Appconfig 中 @Bean 方法 。 


@Configuration 
public class AppConfig { 


@Autowired 
private DataSource dataSource; 


@Bean 
public AccountRepository accountRepository() { 
return new JdbcAccountRepository(dataSource) ; 


@Bean 
public TransferService transferService() { 
return new TransferService(accountRepository()); 


system-test-config.xmlI: 


<beans> 
<!-- enable processing of annotations such as @Autowired and @Configuration --> 


<context:annotation-config/> 
<context:property-placeholder location="classpath:/com/acme/jdbc.properties"/> 


<bean class="com.acme.AppConfig"/> 


<bean class="org.springframework.jdbc.datasource.DriverManagerDataSource"> 
<property name="url" value="${jdbc.url}"/> 
<property name="username" value="${jdbc.username}"/> 
<property name="password" value="${jdbc.password}"/> 
</bean> 
</beans> 


jdbc.properties: 
jdbc.url=jdbc:hsqldb:hsql://localhost/xdb 
jdbc.username=sa 

jdbc.password= 


public static void main(String[] args) { 
ApplicationContext ctx = new ClassPathXmlApplicationContext("classpath:/com/acme/s 


ystem-test-config.xml"); 
TransferService transferService = ctx.getBean(TransferService.class); 


Wh asa 


在 上 面 的 system-test-config. xml 文件 中 ” AppConfig 的 <bean/> 定义 没有 声明 id 元 
素 。 这 么 做 也 是 可 以 接受 的 ， 就 不 必 让 其 它 bean 去 引用 它 了 ， 同 时 也 就 不 可 能 从 容器 中 
a 


通过 明确 的 名 称 来 获取 它 了 。 同 样 地 ， DataSource bean’ MN RH AMARA PAW 
的 bean id 就 不 严格 要 求 了 。 


因为 @Configuration 是 使 用 @Component 来 元 数据 注解 的 2 被 @Configuration 注解 的 类 是 自 动 
作为 组 件 扫描 的 候选 者 的 。 使 用 上 面相 同 的 场景 ， 我 们 可 以 重新 来 定义 system-test- 
config.xml 文件 来 利用 组 件 扫描 的 优点 。 注 意 这 种 情况 下 ， 我 们 不 需要 明确 地 声 

明 <context:annotation-config/> ， 因为 <context : component -scan/> 开启 了 相同 的 功能 。 


system-test-config.xml: 


<beans> 
<!-- picks up and registers AppConfig as a bean definition --> 
<context:component-scan base-package="com.acme"/> 
<context:property-placeholder location="classpath:/com/acme/jdbc.properties"/> 


<bean class="org.springframework.jdbc.datasource.DriverManagerDataSource"> 
<property name="url" value="${jdbc.url}"/> 
<property name="username" value="${jdbc.username}"/> 
<property name="password" value="${jdbc.password}"/> 
</bean> 
</beans> 


iż M T @lmportResource + ~ XML“) @Configuration& 4 Fs 

在 @Configuration 类 作为 配置 容器 主要 机 制 的 应 用 程序 中 ， 使 用 一 些 XML 还 是 必要 的 。 在 这 
些 情况 中 ， 仅 仅 使 用 @ImportResource 来 定义 XML 就 可 以 了 。 这 么 来 做 就 实现 了 "Java 为 中 
心 ” 的 方式 来 配置 容器 并 保持 XML 在 最 低 限 度 。 


@Configuration 
@ImportResource("classpath: /com/acme/properties-config. xml") 
public class AppConfig { 


@Value("${jdbc.ur1}") 
private String url; 


@Value("${jdbc.username}" ) 
private String username; 


@Value("${jdbc.password}") 
private String password; 


@Bean 
public DataSource dataSource() { 
return new DriverManagerDataSource(url, username, password); 


properties-config. xml 
<beans> 


<context:property-placeholder location="classpath:/com/acme/jdbc.properties"/> 
</beans> 


jdbc.properties 
jdbc.url=jdbc:hsqldb:hsal://localhost/xdb 
jdbc.username=sa 

jdbc.password= 


public static void main(String[] args) { 

ApplicationContext ctx = new AnnotationConfigApplicationContext(AppConfig.cla 
SS); 

TransferService transferService = ctx.getBean(TransferService.class); 

2 eee 


环境 的 抽象 


Environment 是 一 个 集成 到 容器 之 中 的 特殊 抽象 它 针 对 应 用 的 环境 建立 了 两 个 关键 的 概 


re profile 和 properties . 


profile 是 命名 好 的 ， 其 中 包含 了 多 个 Bean 的 定义 的 一 个 逻辑 集合 ， 只 有 当 指 定 的 profile 被 激活 
的 时 候 ， 其 中 的 Bean 才 会 激活 。 无 论 是 通过 XML 定义 的 还 是 通过 注解 解析 的 Bean 都 可 以 配置 
到 profile 之 中 。 而 Environment 对 象 的 角色 就 是 跟 profile 相 关联 ， 然 后 决定 来 激活 哪 一 个 
profile， 还 有 哪 一 个 profile 为 默认 的 profile。 


properties 在 几乎 所 有 的 应 用 当中 都 有 着 重要 的 作用 ， 当 然 也 可 能 存在 多 个 数据 源 : property 
文件 ，JVM 系 统 property， 系 统 环境 变量 ，JNDI，servlet 上 下 文 参数 ，ad-hoc 属 性 对 象 ，Map 
等 。 Environment 对 象 和 property 相 关联 ， 然 后 来 给 开发 者 一 个 方便 的 服务 接口 来 配置 这 些 数 
据 源 ， 并 正确 解析 。 


Bean £ X tJ profile 


在 容器 之 中 ，Bean 定 义 profile 是 一 种 允许 不 同 环境 注册 不 同 bean 的 机 制 。 环 境 的 概念 就 意 ? 
着 不 同 的 Bean 对 应 不 同 的 开发 者 ， 而 且 这 个 特性 在 以 下 场景 使 用 十 分 便利 : 


e@ 解决 一 些 内 存 中 的 数据 源 的 问题 ， 可 以 在 不 同 环境 访问 不 同 的 数据 源 ， 开 发 环境 ，QA 测 
试 环境 ， 生 产 环境 等 。 

© 仅仅 在 开发 环境 来 使 用 一 些 监视 服务 

。 在 不 同 的 环境 ， 使 用 不 同 的 bean 实 现 


下 面 参 考 一 个 例子 ? 下 面 的 应 用 需要 一 个 DataSource ， 在 一 个 测试 的 环境 下 2 可 能 类 似 如 下 
代码 : 


@Bean 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder () 
. setType(EmbeddedDatabaseType. HSQL) 
.addScript("my-schema.sql") 
.addScript("my-test-data.sql") 
.build(); 


现在 考虑 如 果 应 用 部 署 到 QA 环境 或 者 生产 环境 ， 假 设 应 用 的 数据 源 是 服务 器 上 的 JNDI 目 录 的 
话 ， 我 们 的 DataSource 可 能 会 如 下 : 


@Bean(destroyMethod="" ) 
public DataSource dataSource() throws Exception { 
Context ctx = new InitialContext(); 
return (DataSource) ctx.lookup("java:comp/env/jdbc/datasource"); 


问题 就 是 如 何 基 于 当前 的 环境 来 使 用 不 同 的 配置 。 在 以 前 ，Spring 的 开发 者 开发 了 很 多 的 方法 
来 解决 这 个 问题 ， 通 常 都 依赖 于 系统 环境 变量 和 XML 中 的 <import/> 标签 以 及 占 位 

符 ${placeholder} 等 来 根据 不 同 的 环境 解析 当前 的 配置 文件 。 现 在 Bean 的 profile 属 于 容器 的 
特性 ， 也 是 该 问题 的 解决 方案 之 一 。 


如 果 我 们 泛 化 了 我 们 一 些 特殊 环境 下 引用 的 bean 定 义 ， 我 们 可 以 将 其 中 指定 的 Bean 注 入 到 特 
定 的 context 之 中 ， 而 不 是 所 有 的 context 之 中 了 。 很 多 开发 者 就 希望 能 够 在 一 种 环境 下 使 用 
Bean 定 义 A， 另 一 种 情况 下 使 用 Bean 定 义 B 。 


@Profile 注解 

@Profile 注解 允许 开发 者 来 表示 一 个 组 件 是 否 适 合 在 当前 环境 来 进行 注册 ， 只 有 当前 的 
Profile 是 激活 的 时 候 ， 对 应 的 Bean 才 会 被 注册 到 上 下 文中 。 使 用 前 面 的 例子 ， 代 码 可 以 进行 
如 下 调整 : 


@Configuration 
@Profile("dev") 
public class StandaloneDataConfig { 


@Bean 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder ( ) 
. setType(EmbeddedDatabaseType. HSQL) 
.addScript("classpath:com/bank/config/sql/schema.sql") 
.addScript( "classpath: com/bank/config/sql/test-data.sql") 


.build(); 


@Configuration 
@Profile("production") 
public class JndiDataConfig { 


@Bean(destroyMethod="" ) 
public DataSource dataSource() throws Exception { 
Context ctx = new InitialContext(); 
return (DataSource) ctx.lookup("java:comp/env/jdbc/datasource"); 


@Profile 注解 可 以 当做 元 注解 来 使 用 。 比 如 ， 下 面 所 定义 的 @Production 注解 就 可 以 来 替 
代 @Profile("production") : 


@Target(ElementType. TYPE) 
@Retention(RetentionPolicy.RUNTIME) 
@Profile("production") 

public @interface Production { 


} 


@Profile 注解 也 可 以 在 方法 级 别 使 用 ， 可 以 声明 在 包含 @Bean 注解 的 方法 之 上 : 


@Configuration 
public class AppConfig { 


@Bean 

@Profile("dev") 

public DataSource devDataSource() { 

return new EmbeddedDatabaseBuilder() 

. setType(EmbeddedDatabaseType.HSQL) 
.addScript( "classpath: com/bank/config/sql/schema.sql") 
.addScript("classpath:com/bank/config/sql/test-data.sql") 
.build( ); 


@Bean 
@Profile("production") 
public DataSource productionDataSource() throws Exception { 
Context ctx = new InitialContext(); 
return (DataSource) ctx.lookup("java:comp/env/jdbc/datasource"); 


如 果 配 置 了 @configuration 的 类 同时 配置 了 @profile ， 那 么 所 有 的 配置 了 @Bean 注解 
的 方法 和 @Import 注解 的 相关 的 类 都 会 被 传递 为 该 profile 。 除 非 这 个 Profile 激活 
f> Gms 其 中 的 Bean 定 义 都 不 会 激活 。 如 果 配 置 为 @Component 或 者 @Configuration 的 
类 标记 了 @Profile({"p1", "p2"}) 那么 这 个 类 Profile 是 p1 或 者 p2 的 时 候 才 会 
激活 。 如 果 某 个 profile 的 前 级 是 1 这 个 非 操 作 符 Z @Profile 注解 的 类 会 只 有 当 
前 的 Profile 没 有 激活 的 时 候 才 能 生效 。 举 例 来 说 ， pee. 为 @Profile({"p1", 

"ip2"}) ， 那 么 注册 的 行为 会 在 Profile 为 pi 或 者 是 Profile 为 非 p2 的 时 候 才 会 激活 。 


XML 中 Bean 定 义 的 profile 


在 XML 中 相对 应 配置 是 <beans/> 中 的 profile 属性 。 我 们 在 前 面 配置 的 信息 可 以 被 重 写 到 
XML 文件 之 中 如 下 : 


<beans profile="dev" 
xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlins: jdbc="http://www. springframework.org/schema/jdbc" 
xsi:schemaLocation="..."> 


<jdbc:embedded-database id="dataSource"> 
<jdbc:script location="classpath: com/bank/config/sql/schema.sql"/> 
<jdbc:script location="classpath:com/bank/config/sql/test-data.sql"/> 
</jdbc: embedded-database> 
</beans> 


<beans profile="production" 
xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns: jee="http://www.springframework.org/schema/jee" 
xsi:schemaLocation="..."> 


<jee:jndi-lookup id="dataSource" jndi-name="java:comp/env/jdbc/datasource"/> 
</beans> 


当然 ， 也 可 以 通过 瞬 套 <beans/> 标签 来 完成 定义 部 分 : 


<beans xmlns="http://www. springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns: jdbc="http://www. springframework.org/schema/jdbc" 
xmlns: jee="http://www.springframework.org/schema/jee" 
xsi:schemaLocation="..."> 


<!-- other bean definitions --> 


<beans profile="dev"> 
<jdbc:embedded-database id="dataSource"> 
<jdbc:script location="classpath:com/bank/config/sql/schema.sql"/> 
<jdbc:script location="classpath:com/bank/config/sql/test-data.sql"/> 
</jdbc:embedded-database> 
</beans> 


<beans profile="production"> 
<jee:jndi-lookup id="dataSource" jndi-name="java:comp/env/jdbc/datasource"/> 
</beans> 
</beans> 


spring-bean.xsd 已 经 被 定义 好 ， 可 以 使 用 上 面 例子 之 中 的 这 类 标签 。 这 将 为 XML 文件 的 配置 
提供 更 多 便利 。 


激活 profile 


现在 ， 我 们 已 经 更 新 了 配置 信息 来 使 用 环境 抽象 ， 但 是 我 们 还 需要 告诉 Spring 来 激活 具体 哪 一 
个 profile 。 如 果 我 们 直接 启动 应 用 的 话 ， 现 在 就 回 抛 出 NosuchBeanDefinitionException + 
常 ， 因 为 容器 会 找 不 到 Spring 的 Bean datasource 。 


有 多 种 方法 来 激活 一 个 Profile， 最 直接 的 方式 就 是 通过 编程 的 方式 来 直接 调 
用 Environment API > Applicationcontext 中 包含 这 个 接口 : 


AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(); 
ctx.getEnvironment().setActiveProfiles("dev"); 

ctx.register(SomeConfig.class, StandaloneDataConfig.class, JndiDataConfig.class); 
ctx.refresh(); 


ai 外 的 ，Profile 还 可 以 通过 spring.profiles.active 中 的 属性 来 指定 ， 可 以 通过 系统 环境 变 
量 ，JVM 系 统 变量 ，servlet 上 下 文中 的 参数 ,甚至 是 JNDI 的 一 个 参数 等 来 写 入 。 在 集成 测试 
中 ， 激 活 Profile 可 以 通过 spring-test 中 的 @ActiveProfiles 来 实现 。 


需要 注意 的 是 ，Profile 的 定义 并 不 是 一 种 互 斥 的 关系 ， 我 们 完全 可 以 在 同一 时 间 激 活 多 个 


Profile 的 。 编 程 上 来 说 ， 为 setActiveprofile() 方法 提供 多 个 Profile 的 名 字 即 可 : 


ctx.getEnvironment().setActiveProfiles("profilei", "profile2"); 


也 可 以 通过 spring.profiles.active 来 指定 » 125A 2 Profile) 4 F : 


-Dspring.profiles.active="profile1, profile2" 


默认 profile 
默认 的 Profile 就 表示 默认 启用 的 Profile。 参 者 如 下 代码 : 


@Configuration 
@Profile("default") 
public class DefaultDataConfig { 


@Bean 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder ( ) 
. setType(EmbeddedDatabaseType. HSQL) 
.addScript("classpath:com/bank/config/sql/schema.sql") 
.build( ); 


如 果 没 有 其 他 的 Profile 被 激活 ， 那 么 上 面 代码 定义 的 datasource 就 会 被 创建 ， 这 种 方式 就 是 
为 默认 情况 下 提供 Bean 定 义 的 一 种 方式 。 一 旦 任何 一 个 Profile 激 活 了 ， 默 认 的 Profile 则 不 会 
激活 。 


默认 的 Profile 的 名 字 可 以 通过 Environment 中 的 setDefaultProfiles() 方法 或 者 是 通 
过 spring.profiles.default 属性 来 更 改 。 


Hy PE HR a RR 


Spring 的 environment 的 抽象 提供 了 一 些 层次 化 的 搜索 选项 ， 来 配置 的 源 信息 。 具 体 的 内 容 ， 
参考 如 下 代码 : 


ApplicationContext ctx = new GenericApplicationContext(); 

Environment env = ctx.getEnvironment(); 

boolean containsFoo = env.containsProperty("foo"); 

System.out.println("Does my environment contain the 'foo' property? " + containsFoo); 


在 上 面 的 代码 片段 之 中 ， 我 们 看 到 一 个 high-level 的 查找 Spring 是 否定 义 foo 属性 的 一 种 方 
式 。 为 了 知道 Spring 中 是 否 包含 这 个 属性 ， Environment 对 象 会 针对 PropertySource 的 集合 进 
行 查找 。 PropertySource 是 针对 一 些 key-value 的 属性 对 的 简单 抽象 ， 而 Spring 

的 StandardEnvironment 是 由 两 个 PropertySource 对 象 所 组 成 的 ， 一 个 代表 的 是 JVM 的 系统 属 
性 (可 以 通过 system.getProperties() 来 获取 ) ， 而 另 一 种 则 是 系统 的 环境 变量 〈 通 

过 system.getenv() 来 获取 。 ) 


这 些 默认 的 属性 源 都 是 standardEnvironment 的 代表 ， 在 任何 应 用 之 中 都 可 以 使 

用 。 standardServletEnvironment 则 是 包含 Servlet 配 置 的 环境 信息 ， 其 中 会 包含 很 多 
Servlet 的 配置 和 Servlet 上 下 文 参 数 。 standardPortletEnvironment 类 似 

于 standardServletEnvironment ， 能 够 配置 portlet 上 下 文 参 数 。 可 以 参考 其 Javadoc 了 解 
更 多 信息 。 


pae ， 当 使 用 StandardEnvironment 的 时 候 ， 调 用 env.containsProperty("foo") 将 返回 一 
个 foo 的 系统 属性 ， 或 者 是 foo 的 运行 时 环境 变量 。 


查询 配置 属性 是 按 层 次 来 查询 的 。 软 认 情 况 下 ， 系 统 属性 优 于 系统 环境 变量 ， 所 以 如 
果 foo 属 ， 隆 在 两 个 环境 中 都 有 配置 的 话 ， 那么 在 调用 env. getProperty("foo") 期 间 ， 系 
统 属性 值 会 优先 返回 。 需 要 注意 的 是 ， 属 性 的 值 是 不 会 合并 的 ， 而 是 完全 敌 盖 掉 。 在 一 
个 普通 的 StandardservletEnvironment 之 中 ， 查 找 的 顺序 如 下 ， 优 先 查 找 * 

ServletConfig 参数 (上 比如 Dispatcherservlet LFX) ， 然 后 是 * servletcontext 参数 
(web.xml 中 的 上 下 文 参数 ) ， 再 然后 是 * JNDI 环境 变量 ，JVM 系 统 变 量 〈("-D" 命 令 行 
参数 ) 以 及 JVM 环 境 变 量 (操作 系统 环境 变量 ) 。 


最 重要 的 是 ， 整 个 的 查找 机 制 是 可 以 配置 的 。 也 许 开 发 者 自己 有 些 定义 的 配置 源 信息 想 集成 
到 配置 检索 的 系统 中 去 。 没 问题 ， 只 要 实现 开发 者 自己 的 propertysource 并 且 将 其 加 入 到 当 
前 Environment 的 PropertySources 之 中 即 可 : 


ConfigurableApplicationContext ctx = new GenericApplicationContext(); 
MutablePropertySources sources = ctx.getEnvironment().getPropertySources(); 
sources.addFirst(new MyPropertySource()); 


在 上 面 的 代码 之 中 ， MyPropertySource 被 添加 到 检索 配置 的 第 一 优先 级 之 中 。 如 果 存 在 一 
个 foo 属性 ， 它 将 由 于 其 他 的 PropertySource 之 中 的 foo 属性 优先 返 
回 。 MutablePropertySources API 提 供 一 些 方法 来 允许 精确 控制 配置 源 。 


@PropertySource 注解 


@PropertySource 注解 提供 了 一 种 方便 的 机 制 来 将 PropertySource 增加 到 Spring 
的 Environment 之 中 。 给 定 一 个 文件 app.properties E&L & J key-value 

对 testbean.name=myTestBean ,下 面 的 代码 中 ， 使 用 了 @PropertySource 调 

用 testBean.getName() 将 返回 myTestBean : 


@Configuration 
@PropertySource("classpath:/com/myco/app.properties" ) 
public class AppConfig { 

@Autowired 

Environment env; 


@Bean 

public TestBean testBean() { 
TestBean testBean = new TestBean(); 
testBean.setName(env.getProperty("testbean.name") ); 
return testBean; 


任何 的 @PropertySource 之 中 形 如 中 的 占 位 符 2 都 可 以 被 解析 成 Environment 中 的 属性 
资源 ， 比 如 : 


@Configuration 


@PropertySource("classpath: /com/${my. placeholder :default/path}/app.properties" ) 
public class AppConfig { 

@Autowired 

Environment env; 


@Bean 

public TestBean testBean() { 
TestBean testBean = new TestBean(); 
testBean.setName(env.getProperty("testbean.name") ); 
return testBean; 


假设 上 面 的 my.placeholder 是 我 们 已 经 注册 到 Environment 之 中 的 资源 ， 举 例 来 说 ，JVM 系 
统 属性 或 者 是 环境 变量 的 话 ， 占 位 符 会 解析 成 对 象 的 值 。 如 果 没 有 的 话 ， default/path 会 来 
作为 默认 值 。 如 果 没 有 指定 默认 值 ， 而 且 占 位 符 也 解析 不 出 来 的 话 ， 就 会 抛 


出 IllegalArgumentException ° 


占 位 符 解 析 


WIA 史上 来 说 ’ 占 位 符 的 值 是 只 能 十 对 JVM 系 统 属 性 或 者 环 不 境 变 量 来 解析 的 > 但 是 现在 不 是 
了 ， 因 为 环境 抽象 已 经 继承 到 了 容器 之 中 ， 现 在 很 容易 通过 容器 将 占 位 符 解 析 集 成 。 这 意味 
着 开发 者 可 以 任意 的 配置 占 位 符 : 


e 开发 者 可 以 自由 调整 系统 变量 还 有 环境 变量 的 优先 级 
© 开发 者 可 以 额外 增加 自己 的 属性 源 信 息 


具体 的 说 ， 下 面 的 XML 配置 不 会 在 意 customer 属性 在 哪里 定义 ， 只 有 这 个 值 
在 Environment 之 中 有 效 即 可 : 


<beans> 


<import resource="com/bank/service/${customer }-config.xml"/> 
</beans> 


不 幸 的 是 ，Java 标 准 的 java.net.URL 类 和 标准 的 URL 前 级 处 理 器 都 不 能 很 好 的 提供 对 低级 资 
源 的 访问 。 比 如 : 没有 一 个 标准 的 URL 实现 可 以 用 来 访问 类 路 径 下 或 者 是 相对 

于 ServletContext 的 资源 £ 尽管 可 以 为 专门 的 URL 前 级 注册 新 的 处 理 程 序 (类 似 于 诸 

如 http 之 类 的 前 级 的 现 有 处 理 程序 ) ， 但 是 这 通常 相当 复杂 ， 并 且 URL 接口 仍然 缺少 某 些 
期 望 的 功能 ， 例 如 检查 所 指 的 资源 是 否 存在 的 方法 。 
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9.1 Introduction 介绍 


Aspect-Oriented Programming (面相 切面 编程 AOP) 用 另外 的 一 种 编程 架构 的 思考 来 补充 

Object-Oriented Programming (面相 对 象 编程 OOP)。OOP 主要 的 模块 单元 是 class (类 )， 而 

AOP 是 aspect (切面 ) 。 切 面 使 得 诸如 事务 管理 等 跨越 多 个 类 型 和 对 象 的 关注 点 模块 化 。 
(这 样 的 关注 点 在 AOP 的 字眼 里 往往 被 称 为 crosscutting ( 横 切 关注 点 ) ) 


AOP 是 Spring 里 面 的 主要 的 组 件 。 虽 然 Spring loC 容器 没有 依赖 AOP， 意 味 着 你 不 想 用 的 
时 候 也 无 需 使 用 AOP ， 但 AOP 提供 一 个 非常 有 用 的 中 间 件 解决 方案 来 作为 Spring loC 的 补 
充 。 

Spring 2.0 AOP 


Spring 2.0 引入 了 一 种 更 加 简单 并 且 更 强大 的 方式 来 自 定 义 切面 ， 用 户 可 以 选择 使 用 
schema-based (基于 模式 ) 的 方式 或 者 使 用 @AspectJ 注解 样式 。 这 两 种 风格 都 完全 支持 
Advice (通知 ) 类 型 和 AspectJ 的 切入 点 语言 ， 虽 然 实 际 上 仍然 使 用 Spring AOP 进行 
Weaving ( 织 入 ) 。 


本 章 主要 讨论 Spring 2.0 对 基于 模式 和 基于 @AspectJ 的 AOP 支持 。 Spring 2.0 完全 保留 
了 对 Spring 1.2 的 向 下 兼容 性 ， 下 一 章 10. Spring AOP APIs 将 讨论 Spring 1.2 API 所 提供 
的 底层 的 AOP 支持 。 


Spring 中 所 使 用 的 AOP : 


o 提供 声明 式 企业 服务 ， 特 别 是 为 了 替代 EJB 声明 式 服 务 。 最 重要 的 服务 是 declarative 
transaction management (声明 性 事务 管理 ) ， 这 个 服务 建立 在 Spring 的 抽象 事务 管理 
(transaction abstraction ) 之 上 。 
e 允许 用 户 实现 自 定义 的 切面 ， 用 AOP 来 完善 OOP 的 使 用 。 


如 果 你 只 打算 使 用 通用 的 声明 式 服务 或 者 预先 打包 的 声明 式 中 间 件 服务 ， 例 如 pooling (缓冲 
池 ) ， 你 可 以 不 直接 使 用 AOP， 可 以 忽略 本 章 大 部 分 内 容 


9.1.1 AOP concepts 概念 


首先 让 我 们 从 定义 一 些 重 要 的 AOP 概念 开始 。 这 些 术 语 不 是 Spring 特有 的 。 不幸 的 是 ， 
Spring 术语 并 不 是 特别 的 直观 ; 如 果 Spring 使 用 自己 的 术语 ， 将 会 变 得 更 加 令 人 困惑 。 


。Aspect (切面 ) : 一 个 关注 点 的 模块 化 ， 这 个 关注 点 可 能 会 横 切 多 个 对 象 。 事 务 管理 是 
企业 级 Java 应 用 中 一 个 关于 横 切 关 注 点 的 很 好 的 例子 。 在 Spring AOP 中 ， 切 面 可 以 使 
用 通用 类 ( schema-based 基 于 模式 的 风格 ) 或 者 在 普通 类 中 以 @Aspect 注解 
(@AspectJ 注解 样式 ) 来 实现 。 

e Join point (连接 点 ) : 在 程序 执行 过 程 中 某 个 特定 的 点 ， 比 如 某 方法 调用 的 时 候 或 者 处 


理 异 常 的 时 候 。 在 Spring AOP 中 ， 一 个 连接 点 总 是 代表 一 个 方法 的 执行 。 

e Advice (通知 ) : 在 切面 的 某 个 特定 的 join point (连接 点 ) 上 执行 的 动作 。 通 知 有 各 种 
类 型 ， 其 中 包括 “around”、“before” 和 “after" 等 通知 。 通知 的 类 型 将 在 后 面部 分 进行 讨 
论 。 许 多 AOP 框架 ， 包 括 Spring， 都 是 以 拦截 器 做 通知 模型 ， 并 维护 一 个 以 连接 点 为 中 
心 的 拦截 器 链 。 

e Pointcut (切入 点 ) : 匹配 join point (连接 点 ) 的 断言 。 通 知 和 一 个 切入 点 表达 式 关 
联 ， 并 在 满足 这 个 切入 点 的 连接 点 上 运行 (例如 ， 当 执行 某 个 特定 名 称 的 方法 时 ) 。 切 
入 点 表达 式 如 何 和 连接 点 匹配 是 AOP 的 核心 : Spring 默认 使 用 Aspect) 切入 点 语法 。 

e Introduction (引入 ) : 声明 额外 的 方法 或 者 某 个 类 型 的 字段 。 Spring 允许 引入 新 的 接 
口 (以 及 一 个 对 应 的 实现 ) 到 任何 被 advise (通知 ) 的 对 象 。 例 如 ， 你 可 以 使 用 一 个 引 
入 来 使 bean 实现 IsModified 接口 ， 以 便 简 化 缓存 机 制 。 (在 AspectJ 社区 ， 
Introduction 也 被 称 为 inter-type declaration (内 部 类 型 声明 ) ) 

e Target object (目标 对 象 ) : 被 一 个 或 者 多 个 aspect (WH) 所 advise (通知 ) 的 对 
象 。 也 有 人 把 它 叫 做 advised (被 通知 ) 对 象 。 既然 Spring AOP 是 通过 运行 时 代理 实 
现 的 ， 这 个 对 象 永远 是 一 个 proxied (被 代理 ) 对 象 。 

e AOP proxy (AOPA) : AOP 框架 创建 的 对 象 ， 用 来 实现 aspect contract (wm 32 
约 ) (包括 通知 方法 执行 等 功能 ) 。 在 Spring 中 ，AOP 代理 可 以 是 JDK 动态 代理 或 者 
CGLIB 代理 。 

e Weaving (A) : æ aspect (切面 ) 连接 到 其 它 的 应 用 程序 类 型 或 者 对 象 上 ， 并 创建 
一 个 被 advised (被 通知 ) 的 对 象 。 这 些 可 以 在 编译 时 (例如 使 用 AspectJ 编译 器 ) > 
类 加 载 时 和 运行 时 完成 。 Spring 和 其 他 纯 Java AOP 框架 一 样 ， 在 运行 时 完成 织 入 。 


通知 的 类 


Ks 


e Before advice (前 置 通知 ) : 在 茶 join point (连接 点 ) 之 前 执行 的 通知 ， 但 这 个 通知 不 
能 阻止 连接 点 前 的 执行 《除非 它 抛 出 一 个 异常 ) 。 

e After returning advice (返回 后 通知 ) : 在 茶 join point (连接 点 ) 正常 完成 后 执行 的 通 
知 : 例如 ， 一 个 方法 没有 抛 出 任何 异常 ， 正 常 返回 。 

e After throwing advice ( 抛 出 异常 后 通知 ) : 在 方法 抛 出 异常 退出 时 执行 的 通知 。 

e After (finally) advice (最 后 通知 ) : 当 某 join point (连接 点 ) 退出 的 时 候 执行 的 通知 
(不 论 是 正常 返回 还 是 异常 退出 ) © 

e 环绕 通知 (Around Advice) : 包围 一 个 join point (连接 点 ) 的 通知 ， 如 方法 调用 。 这 是 
最 强大 的 一 种 通知 类 型 。 环绕 通知 可 以 在 方法 调用 前 后 完成 自 定 义 的 行为 。 它 也 会 选择 
是 否 继续 执行 连接 点 或 直接 返回 它们 自己 的 返回 值 或 抛 出 异常 来 结束 执行 。 


环绕 通知 是 最 常用 的 一 种 通知 类 型 。 跟 AspectJ 一 样 ，Spring 提供 所 有 类 型 的 通知 ， 我 们 推 
背 你 使 用 尽量 简单 的 通知 类 型 来 实现 需要 的 功能 。 例 如， 如 果 你 只 是 需要 用 一 个 方法 的 返回 
值 来 更 新 缓存 ， 虽 然 使 用 环绕 通知 也 能 完成 同样 的 事情 ， 但 是 你 最 好 使 用 After returning 通 
知 而 不 是 环绕 通知 。 用 最 合适 的 通知 类 型 可 以 使 得 编程 模型 变 得 简单 ， 并 且 能 够 过 免 很 多 潜 
在 的 错误 。 比如 ， 你 不 需要 调用 JoinPoint (用 于 Around Advice) 的 proceed() 方法 ， 就 
不 会 有 调用 的 问题 。 


在 Spring 2.0 中 ， 所 有 的 通知 参数 都 是 静态 类 型 ， 因 此 你 可 以 使 用 合适 的 类 型 (例如 一 个 方法 
执行 后 的 返回 值 类 型 ) 作为 通知 的 参数 而 不 是 使 用 一 个 对 象 数组 。 


pointcut 〈 切 入 点 ) 和 join point (连接 点 ) 匹配 的 概念 是 AOP 的 关键 ， 这 使 得 AOP FEF 
其 它 仅仅 提供 拦截 功能 的 加 技术 。 切入 点 使 得 advice 〈 通 知 ) 可 独立 于 OO 层次 。 例如 ， 
一 个 提供 声明 式 事务 管理 的 around 通知 可 以 被 应 用 到 一 组 横 跨 多 个 对 象 中 的 方法 上 (例如 服 
务 层 的 所 有 业务 操作 ) 。 


9.1.2 Spring AOP capabilities and goals 功能 和 目标 


Spring AOP 用 纯 Java 实现 。 它 不 需要 专门 的 编译 过 程 。Spring AOP 不 需要 控制 类 装载 器 层 
次 ， 因 此 它 适 用 于 Servlet 容器 或 应 用 服务 器 。 


Spring 目前 仅 支持 使 用 方法 调用 作为 join point (连接 点 ) (在 Spring bean 上 通知 方法 的 执 
行 ) 。 虽然 可 以 在 不 影响 到 Spring AOPHS API 的 情况 下 加 入 对 成 员 变量 拦 截 器 支持 ， 但 
Spring 并 没有 实现 成 员 变 量 拦截 器 。 如果 你 需要 通知 对 成 员 变 量 的 访问 和 更 新 连接 点 ， 可 以 
考虑 其 它 语言 ， 例 如 AspectJ ° 


Spring 实现 AOP 的 方法 跟 其 他 的 框架 不 同 。Spring 并 不 是 要 尝试 提供 最 完整 的 AOP 实现 
(尽管 Spring AOP 有 这 个 能 力 ) ， 相 反 的 ， 它 其 实 侧重 于 提供 一 种 AOP 实现 和 Spring loC 
容器 的 整合 ， 用 于 帮助 解决 在 企业 级 开发 中 的 常见 问题 。 


因此 ，Spring AOP 通常 都 和 Spring loc 容器 一 起 使 用 。 Aspect 使 用 普通 的 bean 定义 语法 

(尽管 Spring 提供 了 强大 的 “autoproxying (自动 代理 ) "功能 ) : 与 其 他 AOP 实现 相 比 这 是 
一 个 显著 的 区 别 。 有 些 事 使 用 Spring AOP 是 无 法 轻松 或 者 高 效 的 完成 的 ， 比 如 说 通知 一 个 细 
粒度 的 对 象 。 这 种 时 候 ， 使 用 AspectJ 是 最 好 的 选择 。 不 过 经 验 告诉 我 们 : 于 大 多 数 在 企业 
级 Java 应 用 中 遇 到 的 问题 ， 只 要 适合 AOP 来 解决 的 ， Spring AOP 都 没有 问题 ，Spring 
AOP 提供 了 一 个 非常 好 的 解决 方案 。 


Spring AOP 从 来 没有 打算 通过 提供 一 种 全 面 的 AOP 解决 方案 来 取代 AspectJ。 我 们 相信 无 

论 是 proxy-based (基于 代理 ) 的 框架 比如 说 Spring AOP 亦 或 是 full-blown 的 框架 比如 说 是 
AspectJ 都 是 很 有 价值 的 ， 他 们 之 间 的 关系 应 该 是 互补 而 不 是 竞争 的 关系 。 Spring TAL 
的 整合 Spring AOP > loC 和 AspectJ， 使 得 所 有 的 AOP 应 用 完全 融入 基于 Spring 的 应 用 体 
系 。 这 样 的 集成 不 会 影响 Spring AOP API 或 者 AOP Alliance API ; Spring AOP 保 留 了 向 下 

兼容 性 。 下 一 章 10. Spring AOP APls 会 详细 讨论 Spring AOP API ° 


一 个 Spring Framework 的 核心 原则 是 non-invasiveness( 非 侵袭 性 ) ; 这 意味 着 你 不 应 该 在 您 
的 业务 / 域 模型 被 迫 引 入 框架 特定 的 类 和 接口 。 然 而 ， 在 一 些 地 方 ，Spring Framework 可 以 让 
你 选择 引入 Spring Framework 特定 的 依赖 关系 到 你 的 代码 ， 给 你 这 样 选择 的 理由 是 因为 在 某 
些 情况 下 它 可 能 是 更 容易 读 或 编写 一 些 特定 功能 。Spring Framework (几乎 ) 总 是 给 你 的 选 
择 : 你 可 以 自由 的 做 出 明智 的 决定 ， 选 择 最 适合 您 的 特定 用 例 或 场景 。 


这 样 的 选择 与 本 章 有 关 的 是 AOP 框 架 (和 AOP 类 型 ) 选择 。 你 可 以 选择 AspectJ 和 /或 
Spring AOP ， 你 也 可 以 选择 @AspectJ 注解 式 的 方法 或 Spring 的 XML 配置 方式 。 事 实 上 ， 
本 章 以 介绍 @AspectI 风格 为 先 不 应 该 被 视 为 Spring 团队 倾向 于 @AspectJ 的 方法 胜 过 在 
Spring 的 XML 配置 方式 。 


见 9.4. Choosing which AOP declaration style to use 里 面 有 更 完整 的 每 种 风格 的 使 用 原因 探 
it © 


9.1.3 AOP Proxies 代理 


Spring 缺 省 使 用 标准 JDK dynamic proxies (动态 代理 ) 来 作为 AOP 的 代理 。 这 样 任何 接口 
(或 者 接口 的 set) 都 可 以 被 代理 。 


Spring 也 支持 使 用 CGLIB 代理 . 对 于 需要 代理 类 而 不 是 代理 接口 的 时 候 CGLIB 代理 是 很 有 必 
要 的 。 如 果 一 个 业务 对 象 并 没有 实现 一 个 接口 ， 默 认 就 会 使 用 CGLIB。 此 外 ， 面 向 接口 编程 
也 是 一 个 最 佳 实践 ， 业 务 对 象 通常 都 会 实现 一 个 或 多 个 接口 。 此 外 ， 还 可 以 强制 的 使 用 
CGLIB， 在 那些 (希望 是 罕见 的 ) 在 你 需要 通知 一 个 未 在 接口 中 声明 的 方法 的 情况 下 ， 或 者 
当 你 需要 传递 一 个 代理 对 象 作 为 一 种 具体 类 型 到 方法 的 情况 下 。 


一 个 重要 的 事实 是 ，Spring AOP 是 proxy-based (基于 代理 )。 见 第 9.6.1， "理解 AOP 代理 " 理 
解 这 个 含义 


